必需的请求参数

要向 Maps Datasets API 发出请求,您必须添加以下内容:

  • Google Cloud 项目的编号或 ID, X-Goog-User-Project 标头。该值决定了 用于结算和用量配额计算的项目。

  • 请求的 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

您可以直接将 gcloud 命令添加到 Authorization 标头中的 每个请求生成新令牌的 c网址 命令,如下例所示 。

或者,您也可以设置一个包含令牌的环境变量,然后 将环境变量作为请求的一部分传递:

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