如要對 Maps Datasets API 提出任何要求,請務必納入:
在要求的
X-Goog-User-Project
標頭中,Google Cloud 專案的編號或 ID。這個值會決定用於計算帳單和用量配額的專案。要求
Authorization
標頭中的 OAuth 權杖。如要進一步瞭解如何搭配 Maps Datasets API 使用 OAuth,請參閱「使用 OAuth」一文。要求網址中的 Google Cloud 專案編號或 ID。這個值可指定包含該資料集的專案。雖然這項專案通常與
X-Goog-User-Project
標頭中指定的專案相同,但不必相同。要求網址中的資料集 ID。每當您對特定資料集執行動作時,都會將資料集的 ID 做為要求網址的一部分傳送。
舉例來說,如要刪除資料集:
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
取得專案編號
如要取得 Google Cloud 專案的 PROJECT_NUMBER_OR_ID,請按照下列指示操作:
在 Cloud 控制台中,前往專案的「總覽」頁面。
如果出現系統提示,請選取您的專案。
「Project number」和「Project ID」會顯示在總覽畫面的「Project info」區域中。
取得 OAuth 權杖
如要進行驗證,API 要求的 Authorization
標頭必須包含 OAuth 權杖。詳情請參閱「使用 OAuth」。
舉例來說,您可以使用以下 gcloud
指令產生權杖:
gcloud auth application-default print-access-token
您可以將 gcloud
指令直接納入 cURL 指令的 Authorization
標頭中,以針對每個要求產生新權杖,如上例所示。
或者,您也可以設定包含憑證的環境變數,然後將環境變數做為要求的一部分傳遞:
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