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

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

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

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

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

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