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

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

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

  توجه: اگر از حساب سرویس برای اصالت‌سنجی استفاده می‌کنید، می‌توانید سرصفحه X-Goog-User-Project را حذف کنید. برای اطلاعات بیشتر درباره حساب‌های سرویس، به اصالت‌سنجی در Google مراجعه کنید.

• کد 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 برای استفاده در محیط تولید درنظر گرفته نشده است. از این روش فقط برای محیط توسعه یا آزمایش استفاده کنید.

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