- בקשת HTTP
- פרמטרים של נתיב
- פרמטרים של שאילתה
- גוף הבקשה
- גוף תגובה
- היקפי הרשאה
- תמונה
- תמונה ממוזערת
- סטָטוּס
- נסה זאת!
מציג תמונות ממוזערות של תמונות המצורפות לשלב.
עשוי להחזיר כל אחד מקודי השגיאה הקנוניים הבאים: - PERMISSION_DENIED - אם המשתמש אינו מורשה לקרוא מהפרויקט, או מכל אחת מהתמונות - INVALID_ARGUMENT - אם הבקשה פגומה - NOT_FOUND - אם השלב אינו קיים, או אם אחת מהתמונות לא קיימת
בקשת HTTP
GET https://toolresults.googleapis.com/toolresults/v1beta3/projects/{projectId}/histories/{historyId}/executions/{executionId}/steps/{stepId}/thumbnails
כתובת האתר משתמשת בתחביר GRPC Transcoding .
פרמטרים של נתיב
פרמטרים | |
---|---|
projectId | מזהה פרויקט. נדרש. |
historyId | מזהה היסטוריה. נדרש. |
executionId | מזהה ביצוע. נדרש. |
stepId | מזהה צעד. נדרש. |
פרמטרים של שאילתה
פרמטרים | |
---|---|
pageToken | אסימון המשך לחידוש השאילתה בפריט הבא. אופציונאלי. |
pageSize | המספר המרבי של תמונות ממוזערות לשליפה. ערך ברירת מחדל: 50. השרת ישתמש בברירת המחדל הזו אם השדה אינו מוגדר או בעל ערך של 0. אופציונאלי. |
גוף הבקשה
גוף הבקשה חייב להיות ריק.
גוף תגובה
תגובה המכילה את התמונות הממוזערות בשלב.
אם זה מצליח, גוף התגובה מכיל נתונים עם המבנה הבא:
ייצוג JSON |
---|
{
"thumbnails": [
{
object ( |
שדות | |
---|---|
thumbnails[] | רשימה של נתוני תמונה. תמונות מוחזרות בסדר דטרמיניסטי; הם מסודרים לפי גורמים אלה, לפי סדר החשיבות: * ראשית, לפי מקרה המבחן הקשור אליהם. תמונות ללא מקרה מבחן נחשבות גדולות יותר מתמונות עם אחד. * שנית, לפי זמן היצירה שלהם. תמונות ללא זמן יצירה גדולות יותר מתמונות עם אחד. * שלישית, לפי סדר הוספתם לשלב (על ידי קריאות ל-steps.create או steps.patch). |
nextPageToken | אסימון המשך לחידוש השאילתה בפריט הבא. אם מוגדר, מציין שיש עוד תמונות ממוזערות לקריאה, על ידי קריאה נוספת לרשימה עם הערך הזה בשדה pageToken. |
היקפי הרשאה
דורש את היקף ה-OAuth הבא:
-
https://www.googleapis.com/auth/cloud-platform
למידע נוסף, עיין בסקירת האימות .
תמונה
תמונה, עם קישור לתמונה הראשית ותמונה ממוזערת.
ייצוג JSON |
---|
{ "stepId": string, "sourceImage": { object ( |
שדות | |
---|---|
stepId | השלב אליו מצורפת התמונה. תמיד מוגדר. |
sourceImage | התייחסות לתמונה המקורית בגודל מלא. זה זהה לערך toolOutputs עבור התמונה מתחת לשלב שלה. תמיד מוגדר. |
thumbnail_or_error של שדה איחוד . או תמונה ממוזערת של התמונה, או שגיאה המסבירה מדוע לא ניתן היה לעבד את התמונה הממוזערת. thumbnail_or_error יכול להיות רק אחד מהבאים: | |
thumbnail | התמונה הממוזערת. |
error | שגיאה המסבירה מדוע לא ניתן היה לעבד את התמונה הממוזערת. |
תמונה ממוזערת
תמונה ממוזערת בודדת, עם הגודל והפורמט שלה.
ייצוג JSON |
---|
{ "contentType": string, "heightPx": integer, "widthPx": integer, "data": string } |
שדות | |
---|---|
contentType | סוג התוכן של התמונה הממוזערת, כלומר "תמונה/png". תמיד מוגדר. |
heightPx | גובה התמונה הממוזערת, בפיקסלים. תמיד מוגדר. |
widthPx | רוחב התמונה הממוזערת, בפיקסלים. תמיד מוגדר. |
data | קובץ התמונות הממוזערות עצמו. כלומר, הבתים כאן הם בדיוק הבתים המרכיבים את קובץ התמונות הממוזערות; הם יכולים להיות מוצגים כתמונה כפי שהם (עם סוג התוכן המתאים). תמיד מוגדר. מחרוזת מקודדת base64. |
סטָטוּס
סוג Status
מגדיר מודל שגיאה לוגי המתאים לסביבות תכנות שונות, כולל REST APIs ו-RPC APIs. הוא נמצא בשימוש על ידי gRPC . כל הודעת Status
מכילה שלושה חלקי נתונים: קוד שגיאה, הודעת שגיאה ופרטי שגיאה.
אתה יכול לגלות עוד על מודל שגיאה זה וכיצד לעבוד איתו במדריך עיצוב API .
ייצוג JSON |
---|
{ "code": integer, "message": string, "details": [ { "@type": string, field1: ..., ... } ] } |
שדות | |
---|---|
code | קוד הסטטוס, שאמור להיות ערך enum של |
message | הודעת שגיאה הפונה למפתח, שאמורה להיות באנגלית. כל הודעת שגיאה הפונה למשתמש צריכה להיות מקומית ולשלוח בשדה |
details[] | רשימה של הודעות הנושאות את פרטי השגיאה. יש קבוצה נפוצה של סוגי הודעות לשימוש ממשקי API. אובייקט המכיל שדות מסוג שרירותי. שדה נוסף |