Method: providers.tasks.search

متوقّفة نهائيًا: يمكنك استخدام taskTrackingInfo.get بدلاً منها.

طلب HTTP

GET https://fleetengine.googleapis.com/v1/{parent=providers/*}/tasks:search

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

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

المَعلمات
parent

string

مطلوبة. يجب استخدام التنسيق providers/{provider}. يجب أن يكون موفّر الخدمة هو رقم تعريف مشروع Google Cloud. مثلاً: sample-cloud-project

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

المَعلمات
header

object (DeliveryRequestHeader)

اختياريّ. عنوان الطلب العادي لواجهة برمجة التطبيقات للتسليم العادي.
trackingId

string

مطلوبة. معرّف مجموعة المهام ذات الصلة التي يتم طلبها. تخضع أرقام تعريف التتبّع للقيود التالية:

  • يجب أن تكون سلسلة Unicode صالحة.
  • الحد الأقصى لعدد الأحرف هو 64 حرفًا.
  • تتم تسويتها وفقًا لنموذج تسوية Unicode.
  • لا يجوز أن يحتوي على أي من أحرف ASCII التالية: '/' أو ':' أو '?' أو ',' أو nofollow.
pageSize

integer

اختياريّ. الحد الأقصى لعدد المهام المطلوب عرضها. وقد تعرِض الخدمة قيمة أقل من هذه القيمة. وفي حال عدم تحديد هذه القيمة، يحدد الخادم عدد النتائج المراد عرضها.
pageToken

string

اختياريّ. رمز مميّز للصفحة تم تلقّيه من مكالمة سابقة لـ tasks.search. يجب تقديم هذه القيمة لاسترداد الصفحة التالية.

عند تقسيم النتائج على عدّة صفحات، يجب أن تتطابق جميع المَعلمات الأخرى المقدَّمة إلى tasks.search مع الطلب الذي قدَّم الرمز المميّز للصفحة.

نص الطلب

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

نص الاستجابة

الردّ tasks.search. يحتوي على مجموعة "مهام Google" التي تستوفي معايير البحث في SearchTasksRequest.

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

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

object (Task)

مجموعة المهام الخاصة بقيمة trackingId المطلوبة. ويمكن أن تكون الاستجابة الناجحة فارغة أيضًا. تشير الاستجابة الفارغة إلى أنّه ما مِن مهام مرتبطة بالسمة trackingId المقدَّمة.
nextPageToken

string

مرِّر هذا الرمز المميّز في "SearchTasksRequest" للمتابعة إلى عرض النتائج. وإذا تم عرض جميع النتائج، قد يكون هذا الحقل إما سلسلة فارغة أو لا يظهر في الاستجابة.