Method: projects.datasets.get
تنظيم صفحاتك في مجموعات
يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
تحصل على مجموعة البيانات.
طلب HTTP
GET https://mapsplatformdatasets.googleapis.com/v1/{name=projects/*/datasets/*}
يستخدِم عنوان URL بنية تحويل ترميز gRPC.
مَعلمات المسار
| المعلمات |
name |
string
مطلوبة. اسم المورد. التنسيق: projects/{project}/datasets/{datasetId} ويمكنك أيضًا استرجاع بعض الإصدارات الخاصة من خلال إلحاق "@" وعلامة. التنسيق: projects/{project}/datasets/{datasetId}@{tag} العلامة "active" (نشط): سيتم تضمين معلومات آخر نسخة مكتملة، وNOT_FOUND إذا لم تكن مجموعة البيانات تحتوي على نسخة.
|
نص الطلب
يجب أن يكون نص الطلب فارغًا.
نص الاستجابة
إذا كانت الاستجابة ناجحة، يحتوي نص الاستجابة على مثال Dataset.
نطاقات الأذونات
يجب توفير نطاق OAuth التالي:
https://www.googleapis.com/auth/cloud-platform
أذونات "إدارة الهوية وإمكانية الوصول"
يجب الحصول على إذن إدارة الهوية وإمكانية الوصول التالي في مورد "name":
mapsplatformdatasets.datasets.get
ولمزيد من المعلومات، اطّلِع على مستندات إدارة الهوية وإمكانية الوصول.
إنّ محتوى هذه الصفحة مرخّص بموجب ترخيص Creative Commons Attribution 4.0 ما لم يُنصّ على خلاف ذلك، ونماذج الرموز مرخّصة بموجب ترخيص Apache 2.0. للاطّلاع على التفاصيل، يُرجى مراجعة سياسات موقع Google Developers. إنّ Java هي علامة تجارية مسجَّلة لشركة Oracle و/أو شركائها التابعين.
تاريخ التعديل الأخير: 2025-08-31 (حسب التوقيت العالمي المتفَّق عليه)
[null,null,["تاريخ التعديل الأخير: 2025-08-31 (حسب التوقيت العالمي المتفَّق عليه)"],[[["\u003cp\u003eRetrieves a specific dataset's information using its resource name, including optional version tags.\u003c/p\u003e\n"],["\u003cp\u003eRequires an empty request body and returns a \u003ccode\u003eDataset\u003c/code\u003e object upon success.\u003c/p\u003e\n"],["\u003cp\u003eNeeds \u003ccode\u003ecloud-platform\u003c/code\u003e OAuth scope and \u003ccode\u003emapsplatformdatasets.datasets.get\u003c/code\u003e IAM permission for access.\u003c/p\u003e\n"],["\u003cp\u003eUtilizes gRPC Transcoding syntax in the HTTP request URL for resource identification.\u003c/p\u003e\n"]]],["This outlines how to retrieve a dataset using a `GET` HTTP request to a specific URL, defined by a dataset `name` in the format `projects/{project}/datasets/{datasetId}`. The request body must be empty. A successful response returns a `Dataset` instance. Authorization requires the OAuth scope `https://www.googleapis.com/auth/cloud-platform` and the IAM permission `mapsplatformdatasets.datasets.get` on the dataset resource. You can fetch special versions by adding a tag.\n"],null,["# Method: projects.datasets.get\n\n- [HTTP request](#body.HTTP_TEMPLATE)\n- [Path parameters](#body.PATH_PARAMETERS)\n- [Request body](#body.request_body)\n- [Response body](#body.response_body)\n- [Authorization scopes](#body.aspect)\n- [IAM Permissions](#body.aspect_1)\n\nGets the dataset.\n\n### HTTP request\n\n`GET https://mapsplatformdatasets.googleapis.com/v1/{name=projects/*/datasets/*}`\n\nThe URL uses [gRPC Transcoding](https://google.aip.dev/127) syntax.\n\n### Path parameters\n\n| Parameters ||\n|--------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `name` | `string` Required. Resource name. Format: projects/{project}/datasets/{datasetId} Can also fetch some special versions by appending \"@\" and a tag. Format: projects/{project}/datasets/{datasetId}@{tag} Tag \"active\": The info of the latest completed version will be included, and NOT_FOUND if the dataset does not have one. |\n\n### Request body\n\nThe request body must be empty.\n\n### Response body\n\nIf successful, the response body contains an instance of [Dataset](/maps/documentation/datasets/reference/rest/v1/projects.datasets#Dataset).\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 `name` resource:\n\n- `mapsplatformdatasets.datasets.get`\n\nFor more information, see the [IAM documentation](https://cloud.google.com/iam/docs)."]]
