כדי לשלוח בקשה אל 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:
עוברים אל הפרויקט דף הסקירה הכללית במסוף 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