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

لإرسال أيّ طلب إلى واجهة برمجة تطبيقات مجموعات البيانات في "خرائط 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