必要的要求參數

如要對 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 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