使用 Maps Booking API 进行身份验证

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

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

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

使用 Actions Center 设置 Google Cloud 项目

  1. 登录您的 Google Cloud Platform 账号。
  2. 您可以为此目的 创建一个新项目，也可以使用现有项目。
    • 请记下云项目编号，因为您将在 后续步骤中需要用到它。您还可以在 Google Cloud Platform 首页上找到云项目编号。云项目编号始终仅包含数字 。
  3. 登录合作伙伴门户。
  4. 在合作伙伴门户的“入职任务”页面上提交云项目编号和云项目电子邮件地址（用于管理云项目的电子邮件地址），完成第 1 步。

创建服务账号和 OAuth 凭据

  1. 重新登录您的 Google Cloud Platform 账号。
  2. 前往 IAM 和管理 > 服务账号。
  3. 搜索您现有或新创建的云项目 ID。
  4. 创建服务账号。
  5. 填写服务账号详细信息。
  6. 为新服务账号分配最适合您应用需求的的角色。 选择服务账号的角色不会影响对 Google Maps Booking API 进行的调用 ，因为使用这些 API 的配额分配是由您在 Actions Center 配置中关联的项目编号决定的 。如果您不确定要选择哪个角色，只需选择“项目”>“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 凭据中创建的服务账号密钥。

仍然看到错误？

如果您在按照这些步骤操作后仍然看到错误， 请与您的 Actions Center 联系人联系，并提供以下信息：

  • 云项目编号和项目 ID，并附上屏幕截图
  • 服务账号 ID
  • 用于创建服务账号的电子邮件地址
  • 尝试发出请求的端点详细信息
  • 尝试发出请求的时间
  • 发出请求时收到的完整请求和错误消息。