Method: providers.tasks.search

منسوخ شده: به جای آن از taskTrackingInfo.get استفاده کنید.

درخواست HTTP

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

URL از دستور GRPC Transcoding استفاده می کند.

پارامترهای مسیر

مولفه های
parent

string

ضروری. باید در قالب providers/{provider} باشد. ارائه دهنده باید شناسه پروژه Google Cloud باشد. به عنوان مثال، sample-cloud-project .

پارامترهای پرس و جو

مولفه های
header

object ( DeliveryRequestHeader )

اختیاری. هدر درخواست استاندارد Delivery API.

trackingId

string

ضروری. شناسه مجموعه وظایف مرتبط در حال درخواست. شناسه های ردیابی مشمول محدودیت های زیر هستند:

  • باید یک رشته یونیکد معتبر باشد.
  • حداکثر به طول 64 کاراکتر محدود شده است.
  • طبق فرم C عادی سازی یونیکد نرمال شده است.
  • ممکن است حاوی هیچ یک از کاراکترهای ASCII زیر نباشد: «/»، «:»، «؟»، «،»، یا «#».
pageSize

integer

اختیاری. حداکثر تعداد وظایف برای بازگشت. این سرویس ممکن است کمتر از این مقدار را بازگرداند. اگر این مقدار را مشخص نکنید، سرور تعداد نتایجی را که باید برگرداند را تعیین می کند.

pageToken

string

اختیاری. یک نشانه صفحه، دریافت شده از یک تماس قبلی tasks.search . برای بازیابی صفحه بعدی باید این مقدار را ارائه دهید.

هنگام صفحه بندی، تمام پارامترهای دیگر ارائه شده به tasks.search باید با فراخوانی که توکن صفحه را ارائه می کند مطابقت داشته باشد.

درخواست بدن

بدنه درخواست باید خالی باشد.

بدن پاسخگو

پاسخ tasks.search . این شامل مجموعه ای از وظایف است که با معیارهای جستجو در SearchTasksRequest مطابقت دارد.

در صورت موفقیت آمیز بودن، بدنه پاسخ حاوی داده هایی با ساختار زیر است:

نمایندگی JSON
{
  "tasks": [
    {
      object (Task)
    }
  ],
  "nextPageToken": string
}
زمینه های
tasks[]

object ( Task )

مجموعه وظایف برای trackingId درخواستی . یک پاسخ موفق نیز می تواند خالی باشد. پاسخ خالی نشان می دهد که هیچ وظیفه ای با trackingId ارائه شده مرتبط نیست.

nextPageToken

string

برای ادامه فهرست کردن نتایج، این نشانه را در SearchTasksRequest ارسال کنید. اگر همه نتایج برگردانده شده باشند، این فیلد یا یک رشته خالی است یا در پاسخ ظاهر نمی شود.