使用 Maps Booking API 进行身份验证

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

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

如需了解如何向该 API 发出请求，请参阅本地生活服务广告端到端指南的实时 API 更新部分。

使用 Actions Center 设置您的 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 和管理 > 服务帐号。
  3. 搜索现有或新创建的 Cloud 项目 ID。
  4. 创建服务帐号。
  5. 填写服务帐号详细信息。
  6. 为新服务帐号分配最适合您的应用需求的角色。 为服务帐号选择角色不会对可对 Google Maps Booking API 进行哪些调用产生任何影响，因为是否分配足够的配额来使用它们取决于 Actions Center 配置中的项目编号关联。 如果您不确定要选择哪个角色，只需依次选择“项目”>“查看者”即可。
  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 联系人联系，并提供以下信息：

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