- Żądanie HTTP
- Parametry ścieżki
- Parametry zapytania
- Treść żądania
- Treść odpowiedzi
- Zakresy autoryzacji
- Obraz
- Miniatura
- Stan
- Wypróbuj
Wyświetla miniatury obrazów dołączonych do kroku.
Może zwracać dowolny z tych kanonicznych kodów błędów: - PERMISSION_DENIED – jeśli użytkownik nie jest upoważniony do odczytu z projektu lub z któregoś z obrazów, - Nieprawidłowa_AR, - jeśli żądanie jest uszkodzone, - NOT_FOUND, jeśli krok nie istnieje lub jeśli nie ma żadnego obrazu.
Żądanie HTTP
GET https://toolresults.googleapis.com/toolresults/v1beta3/projects/{projectId}/histories/{historyId}/executions/{executionId}/steps/{stepId}/thumbnails
Adres URL używa składni transkodowania gRPC.
Parametry ścieżki
Parametry | |
---|---|
projectId |
Identyfikator projektu. Wymagane. |
historyId |
Identyfikator historii Wymagane. |
executionId |
Identyfikator wykonania. Wymagane. |
stepId |
Identyfikator kroku. Wymagane. |
Parametry zapytania
Parametry | |
---|---|
pageToken |
Token kontynuacji, który pozwala wznowić zapytanie przy następnym elemencie. Opcjonalnie. |
pageSize |
Maksymalna liczba miniatur do pobrania. Wartość domyślna: 50. Serwer użyje tej wartości domyślnej, jeśli pole nie jest ustawione lub ma wartość 0. Opcjonalnie. |
Treść żądania
Treść żądania musi być pusta.
Treść odpowiedzi
Odpowiedź zawierająca miniatury w kroku.
W przypadku powodzenia treść żądania zawiera dane o następującej strukturze:
Zapis JSON |
---|
{
"thumbnails": [
{
object ( |
Pola | |
---|---|
thumbnails[] |
Lista danych obrazu. Obrazy są zwracane w kolejności deterministycznej. są uporządkowane według ważności: * Najpierw od powiązanego przypadku testowego. Obrazy bez przypadku testowego są uznawane za większe niż obrazy, na których występuje 1. * Po drugie, według czasu utworzenia. Obrazy bez czasu utworzenia mają więcej czasu niż obrazy, które zawierają jeden. * Po trzecie według kolejności dodania do kroku (przez wywołania steps.create lub steps.patch). |
nextPageToken |
Token kontynuacji, który pozwala wznowić zapytanie przy następnym elemencie. Jeśli jest ustawione, wskazuje, że do odczytania jest więcej miniatur, przez ponowne wywołanie listy z tą wartością w polu pageToken. |
Zakresy autoryzacji
Wymaga następującego zakresu protokołu OAuth:
https://www.googleapis.com/auth/cloud-platform
Więcej informacji znajdziesz w artykule o uwierzytelnianiu (w języku angielskim).
Obraz
Zdjęcie z linkiem do zdjęcia głównego i miniatury.
Zapis JSON |
---|
{ "stepId": string, "sourceImage": { object ( |
Pola | |
---|---|
stepId |
Krok, do którego jest dołączony obraz. Zawsze ustawiona. |
sourceImage |
Odwołanie do pełnowymiarowego, oryginalnego zdjęcia. Jest to to samo co wpis toolOutputs dla obrazu w jego kroku. Zawsze ustawiona. |
Pole sumy thumbnail_or_error . Miniatura obrazu lub błąd wyjaśniający, dlaczego nie udało się wyrenderować miniatury. thumbnail_or_error może mieć tylko jedną z tych wartości: |
|
thumbnail |
Miniatura. |
error |
Błąd z wyjaśnieniem, dlaczego nie udało się wyrenderować miniatury. |
Miniatura
Pojedyncza miniatura, jej rozmiar i format
Zapis JSON |
---|
{ "contentType": string, "heightPx": integer, "widthPx": integer, "data": string } |
Pola | |
---|---|
contentType |
Typ treści miniatury, np. „obraz/png”. Zawsze ustawiona. |
heightPx |
Wysokość miniatury w pikselach. Zawsze ustawiona. |
widthPx |
Szerokość miniatury w pikselach. Zawsze ustawiona. |
data |
sam plik miniatury. Oznacza to, że tutaj bajty to dokładnie bajty z pliku miniatury. mogą być wyświetlane jako obrazy w takiej postaci, w jakiej są (z odpowiednim typem treści). Zawsze ustawiona. Ciąg zakodowany w formacie base64. |
Stan
Typ Status
określa logiczny model błędów odpowiedni dla różnych środowisk programowania, w tym interfejsów API typu REST i RPC. Jest używany przez gRPC. Każdy komunikat Status
zawiera 3 elementy danych: kod błędu, komunikat o błędzie i szczegóły błędu.
Więcej informacji na temat tego modelu błędów i sposobu jego działania znajdziesz w przewodniku API Design Guide (w języku angielskim).
Zapis JSON |
---|
{ "code": integer, "message": string, "details": [ { "@type": string, field1: ..., ... } ] } |
Pola | |
---|---|
code |
Kod stanu, który powinien być wartością wyliczeniową równą |
message |
komunikat o błędzie widoczny dla dewelopera. Powinien być w języku angielskim; Każdy komunikat o błędzie widoczny dla użytkowników powinien zostać zlokalizowany i wysłany w polu |
details[] |
Lista komunikatów ze szczegółami błędu. Istnieje typowy zestaw typów wiadomości, których mogą używać interfejsy API. Obiekt zawierający pola dowolnego typu. Dodatkowe pole |