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

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