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

برای ارسال هرگونه درخواست به Maps Datasets API، باید موارد زیر را اضافه کنید:

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

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

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

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

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

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

برای اصالت‌سنجی، درخواست میانای برنامه‌سازی کاربردی شما باید حاوی کد 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