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

لتقديم أيّ طلب إلى Maps Datasets API، عليك تضمين ما يلي:

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

  • رمز OAuth مميز في عنوان Authorization للطلب. لمزيد من المعلومات حول استخدام OAuth مع واجهة برمجة تطبيقات مجموعات بيانات الخرائط، يمكنك الاطّلاع على استخدام 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