使用 Maps Booking API 进行身份验证

如需进行实时更新，您需要向 Maps Booking API 发出请求。Maps Booking API 要求您使用 OAuth 2.0 对请求进行身份验证，该 GCP 服务帐号必须有权访问该 API 并已分配必要的 QPS。本指南将引导您完成以下步骤：

  1. 设置您的 Google Cloud 项目
  2. 创建服务帐号
  3. 在 GCP 项目中启用 Maps Booking API
  4. 调试常见问题

如需了解如何向 API 发出请求，请参阅端到端指南的实时 API 更新部分。

使用“通过 Google 预订”设置 Google Cloud 项目

  1. 登录您的 Google Cloud Platform 帐号。
  2. 为此，您可以创建新项目，也可以使用现有项目。
    • 请记下 Cloud 项目编号，因为您在后续步骤中需要用到该编号。您的云项目编号也可以在 Google Cloud Platform 首页上找到。Cloud 项目编号始终仅为数字。
  3. 登录合作伙伴门户。
  4. 通过提交 Cloud 项目编号和 Cloud 项目电子邮件地址（用于管理 Cloud 项目的电子邮件地址），在合作伙伴门户的 Onboarding Tasks 页面完成第 1 步。

创建服务帐号和 OAuth 凭据

  1. 重新登录您的 Google Cloud Platform 帐号。
  2. 导航到 IAM & admin; 服务帐号。
  3. 搜索现有或新创建的 Cloud 项目 ID。
  4. 创建服务帐号。
  5. 填写服务帐号详细信息。
  6. 为新服务帐号分配最适合您的应用需求的角色。该服务帐号的角色选择不会影响对 Google Maps Booking API 的调用，因为系统是否分配了足够的配额来使用这些配额取决于项目编号在“通过 Google 预订”配置中的关联。如果您不确定要选择哪个角色，只需选择 Project > Viewer。
  7. 在第 (6) 步中点击“继续”后，您可以选择创建 JSON 密钥。
  8. 保存 json 凭据。请务必将这些凭据存储在安全的地方，因为您以后将检索不到它们。
  9. 重新登录合作伙伴门户，并在合作伙伴门户的初始配置任务页面上完成剩余任务。

启用 MapsBooking API

  1. 登录您的 Google Cloud Platform 帐号。
  2. 导航到 API & &; 服务 & 信息中心。
  3. 点击启用 API 和服务，然后搜索 Google Maps Booking API。
  4. 启用以下 API：
    • Google Maps Booking API
    • Google Maps Booking API（开发版）

常见错误

您在提出实时更新请求时可能会遇到授权问题，原因有很多。如果您需要有关如何发出实时更新请求的常规指导，请参阅端到端指南中的实时 API 更新部分。您还可以在代码示例部分找到使用多种语言的示例客户端。

如果您遇到 403 错误，请确认您符合以下所有要求：

  1. 使用 Google 客户端库。
  2. 使用服务帐号身份验证创建 OAuth 凭据。
  3. 针对相应范围进行授权。
  4. 调用相应的端点（如下所列）。

确保您调用了正确的端点：

  1. 沙盒：https://partnerdev-mapsbooking.googleapis.com/v1alpha/...
  2. 正式版：https://mapsbooking.googleapis.com/v1alpha/...

确保您已正确授权 OAuth 凭据请求：

  1. 您正在针对 “https://www.googleapis.com/auth/mapsbooking” 范围进行授权。
  2. 您使用的是在创建服务帐号和 OAuth 凭据中创建的服务帐号密钥。

仍然出现错误？

如果您在执行上述步骤后仍会看到错误，请与您的“通过 Google 预订”联系人联系，并提供以下信息：

  • 带有屏幕截图的 Cloud 项目编号和项目 ID
  • 服务帐号 ID
  • 用于创建服务帐号的电子邮件地址
  • 端点详情已尝试向
  • 请求时间
  • 发出请求时收到的完整请求和错误消息。