- طلب HTTP
- معلمات المسار
- معلمات الاستعلام
- هيئة الطلب
- هيئة الاستجابة
- نطاقات التفويض
- صورة
- ظفري
- حالة
- جربها!
يسرد الصور المصغرة للصور المرفقة بالخطوة.
قد يُرجع أيًا من رموز الخطأ الأساسية التالية: - PERMISSION_DENIED - إذا كان المستخدم غير مصرح له بالقراءة من المشروع، أو من أي من الصور - INVALID_ARGUMENT - إذا كان الطلب مشوهًا - NOT_FOUND - إذا كانت الخطوة غير موجودة، أو إذا كانت أي من الصور غير موجودة
طلب HTTP
GET https://toolresults.googleapis.com/toolresults/v1beta3/projects/{projectId}/histories/{historyId}/executions/{executionId}/steps/{stepId}/thumbnails
يستخدم عنوان URL بناء جملة gRPC Transcoding .
معلمات المسار
حدود | |
---|---|
projectId | معرف المشروع. مطلوب. |
historyId | معرف التاريخ. مطلوب. |
executionId | معرف التنفيذ مطلوب. |
stepId | معرف الخطوة مطلوب. |
معلمات الاستعلام
حدود | |
---|---|
pageToken | رمز استمرار لاستئناف الاستعلام في العنصر التالي. خياري. |
pageSize | الحد الأقصى لعدد الصور المصغرة التي يمكن جلبها. القيمة الافتراضية: 50. سيستخدم الخادم هذه القيمة الافتراضية إذا لم يتم تعيين الحقل أو كانت قيمته 0. خياري. |
هيئة الطلب
يجب أن يكون نص الطلب فارغًا.
هيئة الاستجابة
رد يحتوي على الصور المصغرة في خطوة.
في حالة النجاح، سيحتوي نص الاستجابة على بيانات بالبنية التالية:
تمثيل جيسون |
---|
{
"thumbnails": [
{
object ( |
مجالات | |
---|---|
thumbnails[] | قائمة بيانات الصورة. يتم إرجاع الصور بترتيب حتمي؛ يتم ترتيبها حسب هذه العوامل، حسب الأهمية: * أولاً، حسب حالة الاختبار المرتبطة بها. تعتبر الصور التي لا تحتوي على حالة اختبار أكبر من الصور التي تحتوي على حالة اختبار واحدة. *الثاني: بزمن خلقهم. الصور التي ليس لها وقت إنشاء أكبر من الصور التي لها وقت إنشاء واحد. * ثالثاً حسب الترتيب الذي تمت إضافتهم به إلى الخطوة (بالاستدعاء إلىخطوات.إنشاء أو خطوات.تصحيح). |
nextPageToken | رمز استمرار لاستئناف الاستعلام في العنصر التالي. إذا تم تعيينه، فإنه يشير إلى أن هناك المزيد من الصور المصغرة للقراءة، عن طريق استدعاء القائمة مرة أخرى بهذه القيمة في حقل pageToken. |
نطاقات التفويض
يتطلب نطاق OAuth التالي:
-
https://www.googleapis.com/auth/cloud-platform
لمزيد من المعلومات، راجع نظرة عامة على المصادقة .
صورة
صورة مع رابط للصورة الرئيسية وصورة مصغرة.
تمثيل جيسون |
---|
{ "stepId": string, "sourceImage": { object ( |
مجالات | |
---|---|
stepId | الخطوة التي تم إرفاق الصورة بها. تعيين دائما. |
sourceImage | إشارة إلى الصورة الأصلية بالحجم الكامل. وهذا هو نفس إدخال الأداة Outputs للصورة ضمن الخطوة الخاصة بها. تعيين دائما. |
حقل الاتحاد thumbnail_or_error . إما صورة مصغرة للصورة، أو خطأ يوضح سبب عدم إمكانية عرض الصورة المصغرة. يمكن أن تكون thumbnail_or_error واحدًا فقط مما يلي: | |
thumbnail | الصورة المصغرة. |
error | خطأ يوضح سبب عدم إمكانية عرض الصورة المصغرة. |
ظفري
صورة مصغرة واحدة بحجمها وشكلها.
تمثيل جيسون |
---|
{ "contentType": string, "heightPx": integer, "widthPx": integer, "data": string } |
مجالات | |
---|---|
contentType | نوع محتوى الصورة المصغرة، أي "image/png". تعيين دائما. |
heightPx | ارتفاع الصورة المصغرة بالبكسل. تعيين دائما. |
widthPx | عرض الصورة المصغرة بالبكسل. تعيين دائما. |
data | الملف المصغر نفسه. أي أن البايتات هنا هي بالتحديد البايتات التي يتكون منها الملف المصغر؛ ويمكن تقديمها كصورة كما هي (مع نوع المحتوى المناسب). تعيين دائما. سلسلة مشفرة بـ base64. |
حالة
يحدد نوع Status
نموذج خطأ منطقي مناسب لبيئات برمجة مختلفة، بما في ذلك واجهات برمجة تطبيقات REST وواجهات برمجة تطبيقات RPC. يتم استخدامه بواسطة gRPC . تحتوي كل رسالة Status
على ثلاث أجزاء من البيانات: رمز الخطأ، ورسالة الخطأ، وتفاصيل الخطأ.
يمكنك معرفة المزيد حول نموذج الخطأ هذا وكيفية التعامل معه في دليل تصميم واجهة برمجة التطبيقات (API Design Guide ).
تمثيل جيسون |
---|
{ "code": integer, "message": string, "details": [ { "@type": string, field1: ..., ... } ] } |
مجالات | |
---|---|
code | رمز الحالة، والذي ينبغي أن يكون قيمة تعداد لـ |
message | رسالة خطأ تواجه المطور، والتي يجب أن تكون باللغة الإنجليزية. يجب ترجمة أي رسالة خطأ تواجه المستخدم وإرسالها في الحقل |
details[] | قائمة الرسائل التي تحمل تفاصيل الخطأ. توجد مجموعة شائعة من أنواع الرسائل التي يمكن لواجهات برمجة التطبيقات استخدامها. كائن يحتوي على حقول من نوع عشوائي. يحتوي الحقل الإضافي |