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