- HTTP-Anfrage
- Pfadparameter
- Abfrageparameter
- Anforderungstext
- Antwortkörper
- Berechtigungsbereiche
- Bild
- Miniaturansicht
- Status
- Versuch es!
Listet Miniaturansichten von Bildern auf, die an einen Schritt angehängt sind.
Kann einen der folgenden kanonischen Fehlercodes zurückgeben: – PERMISSION_DENIED – wenn der Benutzer nicht berechtigt ist, aus dem Projekt oder einem der Bilder zu lesen – INVALID_ARGUMENT – wenn die Anfrage fehlerhaft ist – NOT_FOUND – wenn der Schritt nicht existiert, oder falls eines der Bilder nicht existiert
HTTP-Anfrage
GET https://toolresults.googleapis.com/toolresults/v1beta3/projects/{projectId}/histories/{historyId}/executions/{executionId}/steps/{stepId}/thumbnails
Die URL verwendet die gRPC-Transcoding -Syntax.
Pfadparameter
Parameter | |
---|---|
projectId | Eine Projekt-ID. Erforderlich. |
historyId | Eine Verlaufs-ID. Erforderlich. |
executionId | Eine Ausführungs-ID. Erforderlich. |
stepId | Eine Schritt-ID. Erforderlich. |
Abfrageparameter
Parameter | |
---|---|
pageToken | Ein Fortsetzungstoken, um die Abfrage beim nächsten Element fortzusetzen. Optional. |
pageSize | Die maximale Anzahl abzurufender Miniaturansichten. Standardwert: 50. Der Server verwendet diesen Standardwert, wenn das Feld nicht festgelegt ist oder den Wert 0 hat. Optional. |
Anforderungstext
Der Anfragetext muss leer sein.
Antwortkörper
Eine Antwort, die die Miniaturansichten in einem Schritt enthält.
Bei Erfolg enthält der Antworttext Daten mit der folgenden Struktur:
JSON-Darstellung |
---|
{
"thumbnails": [
{
object ( |
Felder | |
---|---|
thumbnails[] | Eine Liste von Bilddaten. Bilder werden in einer deterministischen Reihenfolge zurückgegeben; Sie sind nach diesen Faktoren in der Reihenfolge ihrer Wichtigkeit geordnet: * Erstens nach dem zugehörigen Testfall. Bilder ohne Testfall gelten als größer als Bilder mit einem. * Zweitens nach ihrer Entstehungszeit. Bilder ohne Erstellungszeit sind größer als Bilder mit einer. * Drittens nach der Reihenfolge, in der sie dem Schritt hinzugefügt wurden (durch Aufrufe von „steps.create“ oder „steps.patch“). |
nextPageToken | Ein Fortsetzungstoken, um die Abfrage beim nächsten Element fortzusetzen. Wenn diese Einstellung festgelegt ist, wird angezeigt, dass weitere Miniaturansichten gelesen werden müssen, indem die Liste erneut mit diesem Wert im Feld „pageToken“ aufgerufen wird. |
Berechtigungsbereiche
Erfordert den folgenden OAuth-Bereich:
-
https://www.googleapis.com/auth/cloud-platform
Weitere Informationen finden Sie in der Authentifizierungsübersicht .
Bild
Ein Bild mit einem Link zum Hauptbild und einem Miniaturbild.
JSON-Darstellung |
---|
{ "stepId": string, "sourceImage": { object ( |
Felder | |
---|---|
stepId | Der Schritt, an den das Bild angehängt ist. Immer eingestellt. |
sourceImage | Ein Verweis auf das Originalbild in Originalgröße. Dies ist dasselbe wie der ToolOutputs-Eintrag für das Bild unter seinem Schritt. Immer eingestellt. |
Union-Feld thumbnail_or_error . Entweder eine Miniaturansicht des Bildes oder ein Fehler, der erklärt, warum die Miniaturansicht nicht gerendert werden konnte. thumbnail_or_error kann nur einer der folgenden Werte sein: | |
thumbnail | Das Miniaturbild. |
error | Ein Fehler, der erklärt, warum die Miniaturansicht nicht gerendert werden konnte. |
Miniaturansicht
Ein einzelnes Miniaturbild mit seiner Größe und seinem Format.
JSON-Darstellung |
---|
{ "contentType": string, "heightPx": integer, "widthPx": integer, "data": string } |
Felder | |
---|---|
contentType | Der Inhaltstyp der Miniaturansicht, z. B. „image/png“. Immer eingestellt. |
heightPx | Die Höhe der Miniaturansicht in Pixel. Immer eingestellt. |
widthPx | Die Breite der Miniaturansicht in Pixel. Immer eingestellt. |
data | Die Miniaturbilddatei selbst. Das heißt, die Bytes hier sind genau die Bytes, aus denen die Miniaturbilddatei besteht. Sie können unverändert als Bild bereitgestellt werden (mit dem entsprechenden Inhaltstyp). Immer eingestellt. Eine Base64-codierte Zeichenfolge. |
Status
Der Status
definiert ein logisches Fehlermodell, das für verschiedene Programmierumgebungen geeignet ist, einschließlich REST-APIs und RPC-APIs. Es wird von gRPC verwendet. Jede Status
enthält drei Datenelemente: Fehlercode, Fehlermeldung und Fehlerdetails.
Mehr über dieses Fehlermodell und wie man damit arbeitet, erfahren Sie im API Design Guide .
JSON-Darstellung |
---|
{ "code": integer, "message": string, "details": [ { "@type": string, field1: ..., ... } ] } |
Felder | |
---|---|
code | Der Statuscode, der ein Enumerationswert von |
message | Eine entwicklerseitige Fehlermeldung, die auf Englisch sein sollte. Jede benutzerseitige Fehlermeldung sollte lokalisiert und im Feld |
details[] | Eine Liste von Nachrichten, die die Fehlerdetails enthalten. Es gibt einen gemeinsamen Satz von Nachrichtentypen, die von APIs verwendet werden können. Ein Objekt, das Felder eines beliebigen Typs enthält. Ein zusätzliches Feld |