لتقديم أيّ طلب إلى Maps Datasets API، عليك تضمين ما يلي:
رقم أو معرّف مشروعك على Google Cloud في عنوان
X-Goog-User-Project
للطلب تحدد هذه القيمة المشروع المستخدم لاحتساب الفواتير وحصص الاستخدام.رمز OAuth مميز في عنوان
Authorization
للطلب. لمزيد من المعلومات حول استخدام OAuth مع واجهة برمجة تطبيقات مجموعات بيانات الخرائط، يمكنك الاطّلاع على استخدام 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:
انتقِل إلى صفحة النظرة العامة الخاصة بالمشروع في Cloud Console.
اختَر مشروعك إذا طُلب منك ذلك.
يظهر رقم المشروع ورقم تعريف المشروع في منطقة معلومات المشروع على شاشة النظرة العامة.
الحصول على رمز 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