پارامترهای درخواستی مورد نیاز

برای ارسال هرگونه درخواست به API مجموعه داده‌های نقشه‌ها، باید موارد زیر را وارد کنید:

  • شماره یا شناسه پروژه گوگل کلود شما در سربرگ X-Goog-User-Project درخواست. این مقدار، پروژه مورد استفاده برای محاسبه صورتحساب و سهمیه استفاده را تعیین می‌کند.

  • یک توکن OAuth در سربرگ Authorization درخواست. برای اطلاعات بیشتر در مورد استفاده از OAuth با API مجموعه داده‌های نقشه‌ها، به بخش استفاده از OAuth مراجعه کنید.

  • یک شماره یا شناسه پروژه گوگل کلود در آدرس اینترنتی درخواست. این مقدار، پروژه حاوی مجموعه داده را مشخص می‌کند. اگرچه این پروژه معمولاً همان پروژه مشخص شده در سربرگ X-Goog-User-Project است، اما الزامی برای یکسان بودن آنها وجود ندارد.

  • شناسه مجموعه داده در URL درخواست. هر زمان که عملی را روی یک مجموعه داده خاص انجام می‌دهید، شناسه مجموعه داده را به عنوان بخشی از URL درخواست ارسال می‌کنید.

برای مثال، برای حذف یک مجموعه داده:

curl -X DELETE \
-H 'X-Goog-User-Project: PROJECT_NUMBER_OR_ID' \
-H "Authorization: Bearer $(gcloud auth application-default print-access-token)" \
https://mapsplatformdatasets.googleapis.com/v1/projects/PROJECT_NUMBER_OR_ID/datasets/DATASET_ID

شماره پروژه را دریافت کنید

برای دریافت PROJECT_NUMBER_OR_ID پروژه Google Cloud خود:

  1. به صفحه نمای کلی پروژه در کنسول Cloud بروید.

  2. در صورت درخواست، پروژه خود را انتخاب کنید.

  3. شماره پروژه و شناسه پروژه در قسمت اطلاعات پروژه در صفحه مرور کلی نمایش داده می‌شوند.

یک توکن OAuth دریافت کنید

برای احراز هویت، درخواست API شما باید حاوی یک توکن OAuth در هدر Authorization باشد. برای اطلاعات بیشتر، به بخش «استفاده از OAuth» مراجعه کنید.

برای مثال، از دستور gcloud زیر برای تولید توکن استفاده کنید:

gcloud auth application-default print-access-token

شما می‌توانید دستور gcloud را مستقیماً در هدر Authorization در یک دستور cURL قرار دهید تا در هر درخواست، همانطور که در مثال بالا نشان داده شده است، یک توکن جدید تولید شود.

به عنوان یک روش جایگزین، می‌توانید یک متغیر محیطی حاوی توکن تنظیم کنید و سپس متغیر محیطی را به عنوان بخشی از درخواست ارسال کنید:

export TOKEN=$(gcloud auth application-default print-access-token)
curl -X DELETE \
-H 'X-Goog-User-Project: PROJECT_NUMBER_OR_ID' \
-H "Authorization: Bearer $TOKEN" \
https://mapsplatformdatasets.googleapis.com/v1/projects/PROJECT_NUMBER_OR_ID/datasets/DATASET_ID