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

لإرسال أي طلب إلى Maps Datasets API، يجب تضمين ما يلي:

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

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