כדי לשלוח בקשה ל-API של מערכי הנתונים של מפות Google, צריך לכלול את הפרטים הבאים:
המספר או המזהה של הפרויקט ב-Google Cloud, בכותרת
X-Goog-User-Project
של הבקשה. הערך הזה קובע את הפרויקט שמשמש לחישובי מכסות השימוש והחיוב.אסימון OAuth בכותרת
Authorization
של הבקשה. במאמר שימוש ב-OAuth תוכלו לקרוא מידע נוסף על השימוש ב-OAuth עם ממשק ה-API של מפות Google.מספר או מזהה של פרויקט ב-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.
אם מתבקשים, בוחרים את הפרויקט.
השדות Project number ו-Project ID מופיעים באזור Project info במסך הסקירה הכללית.
קבלת אסימון OAuth
לצורך אימות, בקשת ה-API צריכה לכלול אסימון 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