必要的要求參數

如要向 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 info」區域會顯示專案編號和專案 ID。

取得 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