Method: providers.tasks.list
Tetap teratur dengan koleksi
Simpan dan kategorikan konten berdasarkan preferensi Anda.
Mendapatkan semua Task yang memenuhi kriteria pemfilteran yang ditentukan.
Permintaan HTTP
GET https://fleetengine.googleapis.com/v1/{parent=providers/*}/tasks
URL menggunakan sintaksis gRPC Transcoding.
Parameter jalur
| Parameter |
parent |
string
Wajib. Harus dalam format providers/{provider}. provider harus berupa ID Project Google Cloud. Misalnya, sample-cloud-project.
|
Parameter kueri
| Parameter |
header |
object (DeliveryRequestHeader)
Opsional. Header permintaan Delivery API standar.
|
pageSize |
integer
Opsional. Jumlah maksimum Tasks yang akan ditampilkan. Layanan mungkin menampilkan lebih sedikit dari nilai ini. Jika Anda tidak menentukan nilai ini, server akan menentukan jumlah hasil yang akan ditampilkan.
|
pageToken |
string
Opsional. Token halaman yang diterima dari panggilan tasks.list sebelumnya. Anda dapat menyediakan ini untuk mengambil halaman berikutnya. Saat memberi nomor halaman, semua parameter lain yang diberikan ke tasks.list harus cocok dengan panggilan yang menyediakan token halaman.
|
filter |
string
Opsional. Kueri filter yang akan diterapkan saat mencantumkan Tasks. Lihat http://aip.dev/160 untuk mengetahui contoh sintaksis filter. Jika Anda tidak menentukan nilai, atau jika Anda memfilter string kosong, semua Tasks akan ditampilkan. Untuk mengetahui informasi tentang properti Tugas yang dapat Anda filter, lihat Membuat daftar tugas.
|
Isi permintaan
Isi permintaan harus kosong.
Isi respons
Respons tasks.list yang berisi kumpulan Tasks yang memenuhi kriteria filter di ListTasksRequest.
Jika berhasil, isi respons memuat data dengan struktur berikut:
| Representasi JSON |
{
"tasks": [
{
object (Task)
}
],
"nextPageToken": string,
"totalSize": string
} |
| Kolom |
tasks[] |
object (Task)
Kumpulan Tugas yang memenuhi kriteria pemfilteran yang diminta. Jika tidak ada filter yang ditentukan, permintaan akan menampilkan semua tugas. Respons berhasil juga boleh kosong. Respons kosong menunjukkan bahwa tidak ada Tasks yang ditemukan yang memenuhi kriteria filter yang diminta.
|
nextPageToken |
string
Teruskan token ini di ListTasksRequest untuk terus mencantumkan hasil. Jika semua hasil telah ditampilkan, berarti kolom ini berupa string kosong atau tidak muncul dalam respons.
|
totalSize |
string (int64 format)
Jumlah total Tasks yang cocok dengan kriteria permintaan, di semua halaman.
|
Kecuali dinyatakan lain, konten di halaman ini dilisensikan berdasarkan Lisensi Creative Commons Attribution 4.0, sedangkan contoh kode dilisensikan berdasarkan Lisensi Apache 2.0. Untuk mengetahui informasi selengkapnya, lihat Kebijakan Situs Google Developers. Java adalah merek dagang terdaftar dari Oracle dan/atau afiliasinya.
Terakhir diperbarui pada 2025-08-31 UTC.
[null,null,["Terakhir diperbarui pada 2025-08-31 UTC."],[[["\u003cp\u003eRetrieves all \u003ccode\u003eTask\u003c/code\u003es that meet specified filtering criteria using a \u003ccode\u003eGET\u003c/code\u003e request.\u003c/p\u003e\n"],["\u003cp\u003eAllows filtering by various parameters such as \u003ccode\u003eheader\u003c/code\u003e, \u003ccode\u003epageSize\u003c/code\u003e, \u003ccode\u003epageToken\u003c/code\u003e, and \u003ccode\u003efilter\u003c/code\u003e.\u003c/p\u003e\n"],["\u003cp\u003eRequest body should be empty, with response containing a list of \u003ccode\u003eTask\u003c/code\u003e objects, \u003ccode\u003enextPageToken\u003c/code\u003e, and \u003ccode\u003etotalSize\u003c/code\u003e.\u003c/p\u003e\n"],["\u003cp\u003eUses gRPC Transcoding syntax for the request URL, with \u003ccode\u003eparent\u003c/code\u003e path parameter specifying the provider.\u003c/p\u003e\n"],["\u003cp\u003eIf successful, response includes an array of \u003ccode\u003eTask\u003c/code\u003e objects matching the filter, potentially empty if no tasks match.\u003c/p\u003e\n"]]],["This document details how to retrieve a list of `Task` resources using a `GET` request to the Fleet Engine API. The request URL requires a `parent` path parameter specifying the provider. Optional query parameters include `header`, `pageSize`, `pageToken`, and `filter` to refine the results. The request body must be empty. A successful response contains an array of `Task` objects, a `nextPageToken` for pagination, and `totalSize` indicating the total number of tasks.\n"],null,["# Method: providers.tasks.list\n\n- [HTTP request](#body.HTTP_TEMPLATE)\n- [Path parameters](#body.PATH_PARAMETERS)\n- [Query parameters](#body.QUERY_PARAMETERS)\n- [Request body](#body.request_body)\n- [Response body](#body.response_body)\n - [JSON representation](#body.ListTasksResponse.SCHEMA_REPRESENTATION)\n\nGets all `Task`s that meet the specified filtering criteria.\n\n### HTTP request\n\n`GET https://fleetengine.googleapis.com/v1/{parent=providers/*}/tasks`\n\nThe URL uses [gRPC Transcoding](https://google.aip.dev/127) syntax.\n\n### Path parameters\n\n| Parameters ||\n|----------|-----------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `parent` | `string` Required. Must be in the format `providers/{provider}`. The `provider` must be the Google Cloud Project ID. For example, `sample-cloud-project`. |\n\n### Query parameters\n\n| Parameters ||\n|-------------|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `header` | `object (`[DeliveryRequestHeader](/maps/documentation/mobility/fleet-engine/reference/tasks/rest/v1/DeliveryRequestHeader)`)` Optional. The standard Delivery API request header. |\n| `pageSize` | `integer` Optional. The maximum number of Tasks to return. The service may return fewer than this value. If you don't specify this value, then the server determines the number of results to return. |\n| `pageToken` | `string` Optional. A page token received from a previous `tasks.list` call. You can provide this to retrieve the subsequent page. When paginating, all other parameters provided to `tasks.list` must match the call that provided the page token. |\n| `filter` | `string` Optional. A filter query to apply when listing Tasks. See \u003chttp://aip.dev/160\u003e for examples of filter syntax. If you don't specify a value, or if you filter on an empty string, then all Tasks are returned. For information about the Task properties that you can filter on, see [List tasks](https://developers.google.com/maps/documentation/mobility/fleet-engine/journeys/tasks/find-tasks#filter_listed_tasks). |\n\n### Request body\n\nThe request body must be empty.\n\n### Response body\n\nThe `tasks.list` response that contains the set of Tasks that meet the filter criteria in the `ListTasksRequest`.\n\nIf successful, the response body contains data with the following structure:\n\n| JSON representation |\n|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| ``` { \"tasks\": [ { object (/maps/documentation/mobility/fleet-engine/reference/tasks/rest/v1/providers.tasks#Task) } ], \"nextPageToken\": string, \"totalSize\": string } ``` |\n\n| Fields ||\n|-----------------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `tasks[]` | `object (`[Task](/maps/documentation/mobility/fleet-engine/reference/tasks/rest/v1/providers.tasks#Task)`)` The set of Tasks that meet the requested filtering criteria. When no filter is specified, the request returns all tasks. A successful response can also be empty. An empty response indicates that no Tasks were found meeting the requested filter criteria. |\n| `nextPageToken` | `string` Pass this token in the `ListTasksRequest` to continue to list results. If all results have been returned, then this field is either an empty string, or it doesn't appear in the response. |\n| `totalSize` | `string (`[int64](https://developers.google.com/discovery/v1/type-format)` format)` The total number of Tasks that match the request criteria, across all pages. |"]]
