必需的请求参数

如需向 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

您可以直接在 c网址 命令的 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