Method: projects.datasets.list
تنظيم صفحاتك في مجموعات
يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
يسرد جميع مجموعات البيانات للمشروع المحدد.
طلب HTTP
GET https://mapsplatformdatasets.googleapis.com/v1/{parent=projects/*}/datasets
يستخدِم عنوان URL بنية تحويل ترميز gRPC.
مَعلمات المسار
| المعلمات |
parent |
string
مطلوب. اسم المشروع لسرد جميع مجموعات البيانات الخاصة به. التنسيق: projects/{project}
|
معامِلات طلب البحث
| المعلمات |
pageSize |
integer
تمثّل هذه السمة الحد الأقصى لعدد مجموعات البيانات المطلوب عرضها لكل صفحة. إذا لم تكن محددة (أو صفرًا)، فسيتم عرض جميع مجموعات البيانات.
|
pageToken |
string
الرمز المميّز للصفحة، الذي تم تلقّيه من طلب بيانات سابق على dataset.list. يمكنك توفير هذا الحقل لاسترداد الصفحة التالية.
|
tag |
string
يشير ذلك المصطلح إلى العلامة التي تحدِّد الإصدار المطلوب لكل مجموعة بيانات. يُرجى العلم أنّه عند تحديد التقسيم على صفحات أيضًا، قد تحدث بعض عمليات الفلترة بعد التقسيم على صفحات، ما قد يتسبب في احتواء الاستجابة على مجموعات بيانات أقل من حجم الصفحة، حتى لو لم تكن الصفحة الأخيرة. العلامة "active" (نشط): ستتضمّن كل مجموعة بيانات في الردّ معلومات عن آخر نسخة مكتملة لها، وسيتم تخطّي مجموعة البيانات إذا لم تحتوي على أي نسخة.
|
نص الطلب
يجب أن يكون نص الطلب فارغًا.
نص الاستجابة
كائن الاستجابة في dataset.list
إذا كانت الاستجابة ناجحة، سيحتوي نص الاستجابة على بيانات بالبنية التالية:
| تمثيل JSON |
{
"datasets": [
{
object (Dataset)
}
],
"nextPageToken": string
} |
| الحقول |
datasets[] |
object (Dataset)
جميع مجموعات البيانات للمشروع.
|
nextPageToken |
string
رمز مميز يمكن إرساله كـ pageToken لاسترداد الصفحة التالية. في حال إسقاط هذا الحقل، لن تظهر أي صفحات لاحقة.
|
نطاقات الأذونات
يجب توفير نطاق OAuth التالي:
https://www.googleapis.com/auth/cloud-platform
أذونات "إدارة الهوية وإمكانية الوصول"
يجب الحصول على إذن IAM التالي في مورد "parent":
mapsplatformdatasets.datasets.list
ولمزيد من المعلومات، اطّلِع على مستندات إدارة الهوية وإمكانية الوصول.
إنّ محتوى هذه الصفحة مرخّص بموجب ترخيص Creative Commons Attribution 4.0 ما لم يُنصّ على خلاف ذلك، ونماذج الرموز مرخّصة بموجب ترخيص Apache 2.0. للاطّلاع على التفاصيل، يُرجى مراجعة سياسات موقع Google Developers. إنّ Java هي علامة تجارية مسجَّلة لشركة Oracle و/أو شركائها التابعين.
تاريخ التعديل الأخير: 2025-08-31 (حسب التوقيت العالمي المتفَّق عليه)
[null,null,["تاريخ التعديل الأخير: 2025-08-31 (حسب التوقيت العالمي المتفَّق عليه)"],[[["\u003cp\u003eLists all datasets within a specified Google Cloud project, returning details like dataset information and pagination tokens for accessing further results.\u003c/p\u003e\n"],["\u003cp\u003eAllows filtering by page size, page token, and version tag to customize the dataset retrieval process.\u003c/p\u003e\n"],["\u003cp\u003eRequires authorization with the \u003ccode\u003ecloud-platform\u003c/code\u003e OAuth scope and the \u003ccode\u003emapsplatformdatasets.datasets.list\u003c/code\u003e IAM permission on the target project.\u003c/p\u003e\n"],["\u003cp\u003eUses a simple HTTP GET request with path and query parameters to specify the project and filtering criteria.\u003c/p\u003e\n"],["\u003cp\u003eReturns a JSON response containing an array of datasets and a token for retrieving subsequent pages if available.\u003c/p\u003e\n"]]],["This document outlines the process of listing datasets within a specified project. It uses a `GET` request to the provided URL, including the project name as a required path parameter. Optional query parameters like `pageSize`, `pageToken`, and `tag` can filter and paginate results. The request body must be empty. The response includes an array of dataset objects and a `nextPageToken` for further pagination. The request requires the `mapsplatformdatasets.datasets.list` IAM permission and `https://www.googleapis.com/auth/cloud-platform` OAuth scope.\n"],null,["# Method: projects.datasets.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.ListDatasetsResponse.SCHEMA_REPRESENTATION)\n- [Authorization scopes](#body.aspect)\n- [IAM Permissions](#body.aspect_1)\n\nLists all the datasets for the specified project.\n\n### HTTP request\n\n`GET https://mapsplatformdatasets.googleapis.com/v1/{parent=projects/*}/datasets`\n\nThe URL uses [gRPC Transcoding](https://google.aip.dev/127) syntax.\n\n### Path parameters\n\n| Parameters ||\n|----------|-----------------------------------------------------------------------------------------------------|\n| `parent` | `string` Required. The name of the project to list all the datasets for. Format: projects/{project} |\n\n### Query parameters\n\n| Parameters ||\n|-------------|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `pageSize` | `integer` The maximum number of datasets to return per page. If unspecified (or zero), all datasets will be returned. |\n| `pageToken` | `string` The page token, received from a previous datasets.list call. Provide this to retrieve the subsequent page. |\n| `tag` | `string` The tag that specifies the desired version for each dataset. Note that when pagination is also specified, some filtering can happen after pagination, which may cause the response to contain fewer datasets than the page size, even if it's not the last page. Tag \"active\": Each dataset in the response will include the info of its latest completed version, and the dataset will be skipped if it does not have one. |\n\n### Request body\n\nThe request body must be empty.\n\n### Response body\n\nResponse object of datasets.list.\n\nIf successful, the response body contains data with the following structure:\n\n| JSON representation |\n|--------------------------------------------------------------------------------------------------------------------------------------------|\n| ``` { \"datasets\": [ { object (/maps/documentation/datasets/reference/rest/v1/projects.datasets#Dataset) } ], \"nextPageToken\": string } ``` |\n\n| Fields ||\n|-----------------|--------------------------------------------------------------------------------------------------------------------------------------|\n| `datasets[]` | `object (`[Dataset](/maps/documentation/datasets/reference/rest/v1/projects.datasets#Dataset)`)` All the datasets for the project. |\n| `nextPageToken` | `string` A token that can be sent as `pageToken` to retrieve the next page. If this field is omitted, there are no subsequent pages. |\n\n### Authorization scopes\n\nRequires the following OAuth scope:\n\n- `https://www.googleapis.com/auth/cloud-platform`\n\n### IAM Permissions\n\nRequires the following [IAM](https://cloud.google.com/iam/docs) permission on the `parent` resource:\n\n- `mapsplatformdatasets.datasets.list`\n\nFor more information, see the [IAM documentation](https://cloud.google.com/iam/docs)."]]
