必要的要求參數

如要向 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：

  1. 在 Cloud 控制台中，前往專案的「總覽」頁面。

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

  3. 「Project ID」(專案編號) 和「Project ID」(專案 ID) 會顯示在總覽畫面的「Project info」(專案資訊) 區域。

取得 OAuth 權杖

如要進行驗證，API 要求的 Authorization 標頭中必須包含 OAuth 權杖。詳情請參閱「使用 OAuth」。

例如，您可以使用以下 gcloud 指令產生權杖：

gcloud auth application-default print-access-token

您可以直接在 cURL 指令的 Authorization 標頭中加入 gcloud 指令，為每項要求產生新的權杖，如上例所示。

或者，您也可以設定包含權杖的環境變數，然後將該環境變數做為要求的一部分傳遞：

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