必要的要求參數

如要向 Maps Datasets API 提出任何要求,請務必納入:

  • 專案的 Google Cloud 專案編號或 ID 要求的 X-Goog-User-Project 標頭。這個值會決定 計費專案。

  • 要求的 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

  1. 前往專案的 總覽頁面 在 Cloud 控制台中也能看到

  2. 如果出現系統提示,請選取您的專案。

  3. 「專案編號」和「專案 ID」會顯示在「專案資訊」中。 總覽畫面上的內容

取得 OAuth 權杖

為進行驗證,API 要求的 Authorization 標頭。詳情請參閱「使用 OAuth」。

例如,您可以使用以下 gcloud 指令產生權杖:

gcloud auth application-default print-access-token

您可以直接在 Authorization 標頭中加入 gcloud 指令, 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