Method: projects.histories.executions.steps.thumbnails.list

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

string

Identyfikator projektu.

Wymagane.

historyId

string

Identyfikator historii

Wymagane.

executionId

string

Identyfikator wykonania.

Wymagane.

stepId

string

Identyfikator kroku.

Wymagane.

Parametry zapytania

Parametry
pageToken

string

Token kontynuacji, który pozwala wznowić zapytanie przy następnym elemencie.

Opcjonalnie.

pageSize

integer

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 (Image)
    }
  ],
  "nextPageToken": string
}
Pola
thumbnails[]

object (Image)

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

string

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 (ToolOutputReference)
  },

  // Union field thumbnail_or_error can be only one of the following:
  "thumbnail": {
    object (Thumbnail)
  },
  "error": {
    object (Status)
  }
  // End of list of possible types for union field thumbnail_or_error.
}
Pola
stepId

string

Krok, do którego jest dołączony obraz.

Zawsze ustawiona.

sourceImage

object (ToolOutputReference)

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

object (Thumbnail)

Miniatura.

error

object (Status)

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

string

Typ treści miniatury, np. „obraz/png”.

Zawsze ustawiona.

heightPx

integer

Wysokość miniatury w pikselach.

Zawsze ustawiona.

widthPx

integer

Szerokość miniatury w pikselach.

Zawsze ustawiona.

data

string (bytes format)

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

integer

Kod stanu, który powinien być wartością wyliczeniową równą google.rpc.Code.

message

string

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 google.rpc.Status.details lub zlokalizowany przez klienta.

details[]

object

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 "@type" zawiera identyfikator URI identyfikujący typ. Przykład: { "id": 1234, "@type": "types.example.com/standard/id" }.