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

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

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

  ملاحظة: إذا كنت تستخدم حساب خدمة للمصادقة، يمكنك حذف عنوان X-Goog-User-Project. لمزيد من المعلومات عن حسابات الخدمة، يُرجى الاطّلاع على المصادقة في Google.

• رمز 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 مميز غير مخصص للاستخدام في بيئة إنتاج. استخدِم هذا الإجراء لتطوير أو اختبار البيئة فقط.

للمصادقة، يجب أن يشتمل طلب واجهة برمجة التطبيقات على رمز 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