必要的要求參數

如要向 Maps Datasets API 提出任何要求，請務必加入以下資訊：

  • 在要求的 X-Goog-User-Project 標頭中，顯示 Google Cloud 專案的編號或 ID。這個值會決定用於計算帳單和用量配額的專案。

  • 要求 Authorization 標頭中的 OAuth 權杖。如要進一步瞭解如何搭配使用 OAuth 與 Maps Datasets API，請參閱「使用 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 控制台中專案的「Overview」(總覽) 頁面。

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

  3. 「Project number」和「Project 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