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

لإرسال أيّ طلب إلى واجهة برمجة تطبيقات مجموعات البيانات في "خرائط Google"، يجب تضمين ما يلي:

  • رقم أو معرّف مشروعك على 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