معلَمات الطلب المطلوبة

لإجراء أي طلب إلى Maps Datasets API، يجب تضمين ما يلي:

  • رقم أو معرّف مشروعك على Google Cloud في العنوان X-Goog-User-Project للطلب تحدّد هذه القيمة المشروع المستخدَم في احتساب الفوترة وحصة الاستخدام.

  • رمز OAuth المميز في عنوان Authorization للطلب لمزيد من المعلومات حول استخدام بروتوكول OAuth مع Maps Datasets API، يُرجى الاطّلاع على استخدام بروتوكول OAuth.

  • رقم تعريف أو رقم مشروع Google Cloud في عنوان URL للطلب تحدّد هذه القيمة المشروع الذي يحتوي على مجموعة البيانات. على الرغم من أنّ هذا المشروع يكون عادةً هو نفسه المشروع المحدّد في العنوان 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 Console.

  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