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

لتقديم أي طلب إلى 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. انتقِل إلى صفحة Overview (نظرة عامة) الخاصة بالمشروع في 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