必需的请求参数

若要向 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 控制台中项目的概览页面。

  2. 如果出现提示，请选择您的项目。

  3. 项目编号和项目 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