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

يسرد صورًا مصغّرة للصور المرفقة بالخطوة.

قد يعرض أيًا من رموز الخطأ الأساسية التالية: - hreflang_DENIED - إذا لم يكن المستخدم مصرحًا له بالقراءة من المشروع، أو من أي من الصور - nofollow_فوز - إذا كان الطلب غير صحيح - NOT_FOUND - إذا كانت الخطوة غير موجودة، أو إذا لم تكن أي من الصور موجودة

طلب HTTP

GET https://toolresults.googleapis.com/toolresults/v1beta3/projects/{projectId}/histories/{historyId}/executions/{executionId}/steps/{stepId}/thumbnails

يستخدِم عنوان URL بنية تحويل ترميز gRPC.

مَعلمات المسار

المَعلمات
projectId

string

رقم تعريف المشروع

مطلوب.
historyId

string

رقم تعريف السجلّ

مطلوب.
executionId

string

رقم تعريف التنفيذ.

مطلوب.
stepId

string

رقم تعريف الخطوة

مطلوب.

معامِلات طلب البحث

المَعلمات
pageToken

string

رمز مميز للمتابعة لاستئناف الاستعلام عند العنصر التالي.

هذه السمة اختيارية.
pageSize

integer

الحد الأقصى لعدد الصور المصغّرة التي سيتم جلبها.

القيمة التلقائية: 50. وسيستخدم الخادم هذا الخيار التلقائي إذا لم يتم ضبط الحقل أو إذا كانت قيمته 0.

هذه السمة اختيارية.

نص الطلب

يجب أن يكون نص الطلب فارغًا.

نص الاستجابة

ردّ يحتوي على الصور المصغّرة في خطوة

إذا كانت الاستجابة ناجحة، سيحتوي نص الاستجابة على بيانات بالبنية التالية:

تمثيل JSON 
{
  "thumbnails": [
    {
      object (Image)
    }
  ],
  "nextPageToken": string
}
الحقول
thumbnails[]

object (Image)

قائمة ببيانات الصورة.

يتم إرجاع الصور بترتيب حاسم. يتم ترتيبها حسب هذه العوامل، حسب الأهمية: * أولاً، حسب حالة الاختبار المرتبطة بها. تُعتبر الصور التي لا تتضمّن حالة اختبار أكبر من الصور التي تحتوي على صورة واحدة. * ثانيًا، حسب وقت إنشائها الصور التي لا تتضمّن وقت إنشاء يكون أكبر من عدد الصور التي تحتوي على صورة واحدة. * ثالثًا، حسب ترتيب إضافتها إلى الخطوة (عن طريق عمليات الاتصال بـ steps.create أو steps.patch).
nextPageToken

string

رمز مميز للمتابعة لاستئناف الاستعلام عند العنصر التالي.

في حال ضبطها، يشير ذلك إلى توفّر المزيد من الصور المصغّرة المطلوب قراءتها، عن طريق استدعاء القائمة مرة أخرى بهذه القيمة في حقل pageToken.

نطاقات الأذونات

يتطلب نطاق OAuth التالي:

  • https://www.googleapis.com/auth/cloud-platform

لمزيد من المعلومات، يُرجى الاطّلاع على نظرة عامة حول المصادقة.

صورة

صورة، مع رابط إلى الصورة الرئيسية وصورة مصغّرة.

تمثيل 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.
}
الحقول
stepId

string

الخطوة التي يتم إرفاق الصورة بها.

الضبط دائمًا.
sourceImage

object (ToolOutputReference)

إشارة إلى الصورة الأصلية بالحجم الكامل

هذا هو نفسه إدخال الأدوات "الإخراجات" للصورة ضمن الخطوة.

الضبط دائمًا.
حقل الاتحاد thumbnail_or_error. صورة مصغّرة للصورة أو رسالة خطأ توضّح سبب تعذّر عرضها يمكن أن يكون thumbnail_or_error واحدًا فقط مما يلي:
thumbnail

object (Thumbnail)

الصورة المصغّرة
error

object (Status)

حدث خطأ يشرح سبب تعذّر عرض الصورة المصغّرة.

صورة مصغرة

صورة مصغّرة واحدة بحجمها وتنسيقها

تمثيل JSON 
{
  "contentType": string,
  "heightPx": integer,
  "widthPx": integer,
  "data": string
}
الحقول
contentType

string

نوع محتوى الصورة المصغّرة، مثلاً "image/png".

الضبط دائمًا.
heightPx

integer

ارتفاع الصورة المصغّرة بالبكسل.

الضبط دائمًا.
widthPx

integer

عرض الصورة المصغّرة بالبكسل.

الضبط دائمًا.
data

string (bytes format)

ملف الصورة المصغّرة نفسه

وهذا يعني أن وحدات البايت الموجودة هنا هي بالضبط وحدات البايت التي يتكون منها ملف الصورة المصغرة؛ يمكن عرضها كصورة كما هي (مع نوع المحتوى المناسب).

الضبط دائمًا.

سلسلة بترميز base64.

الحالة

يحدّد النوع Status نموذج خطأ منطقي مناسبًا لبيئات البرمجة المختلفة، بما في ذلك واجهات برمجة تطبيقات REST وواجهات برمجة تطبيقات RPC. وتُستخدَم من قِبل gRPC. تحتوي كل رسالة Status على ثلاث بيانات: رمز الخطأ ورسالة الخطأ وتفاصيل الخطأ.

يمكنك معرفة المزيد من المعلومات عن نموذج الخطأ هذا وكيفية التعامل معه في دليل تصميم واجهة برمجة التطبيقات.

تمثيل JSON 
{
  "code": integer,
  "message": string,
  "details": [
    {
      "@type": string,
      field1: ...,
      ...
    }
  ]
}
الحقول
code

integer

رمز الحالة، الذي يجب أن يكون قيمة تعداد بقيمة google.rpc.Code.
message

string

رسالة خطأ مواجهة للمطوِّر، ويجب أن تكون باللغة الإنجليزية يجب ترجمة أي رسالة خطأ تظهر للمستخدم وإرسالها في الحقل google.rpc.Status.details، أو ترجمتها من خلال البرنامج.
details[]

object

قائمة بالرسائل التي تتضمّن تفاصيل الخطأ. وهناك مجموعة شائعة من أنواع الرسائل التي يمكن لواجهات برمجة التطبيقات استخدامها.

كائن يحتوي على حقول من نوع عشوائي يحتوي الحقل الإضافي "@type" على معرف موارد منتظم (URI) يحدّد النوع. مثال: { "id": 1234, "@type": "types.example.com/standard/id" }