注意:此 API 的 v4.7 版本已发布!请参阅更新日志。仍暂时允许在链中提供与新冠肺炎 (COVID-19) 相关的帖子。

OAuth 设置

如需为您的平台配置 OAuth 2.0,请完成以下步骤:

  1. 配置商家许可征求对话框。

    当商家首次尝试通过使用该 API 的合作伙伴平台访问其“Google 我的商家”帐号时,系统会显示商家许可征求对话框。

  2. 商家许可征求对话框 权限申请。

    向第三方授予对您帐号的访问权限后,Google 会向您发送重要的电子邮件通知。此通知会提醒您(营业地点所有者)帐号数据的访问权限已更改。

    您的 Google 帐号现在会显示有权访问您帐号的应用,并详细说明第三方应用可以访问哪些数据。此外,您随时可以点击移除访问权限按钮以移除应用的访问权限。您可通过该方式控制第三方对您的帐号数据的访问权限。

    有权访问的人

    通过可在 Google Cloud 项目中访问的“商家许可征求对话”,您可以针对已授予帐号访问权限的第三方合作伙伴配置以下许可征求信息:

    1. 应用首页链接:您已授权访问您的帐号第三方合作伙伴的首页。
    2. 应用隐私权政策链接:指向合作伙伴的隐私权政策的链接。
    3. 应用服务条款 (ToS) 链接:指向合作伙伴的服务条款 (TOS) 的链接。

    许可征求配置

    如需详细了解许可征求配置,请参阅设置 OAuth 2.0 > 用户许可

  3. 设置您的应用名称和徽标。

    转销商必须使用与我们的合作伙伴一致的应用名称和徽标,或者具有单独的 Google Cloud 项目,以便与合作伙伴的默认项目区分开。

    应用名称和徽标设置

OAuth 在合作伙伴平台上的用途

平台可以代表所有者和管理员执行操作。这样可以最大限度地减少商家需执行的操作数量,并降低访问者流失率。

所有者和管理员必须先使用自己的 Google 帐号登录合作伙伴平台并缓存其凭据。缓存的 OAuth 2.0 凭据、访问令牌和刷新令牌可用于查看或修改营业地点数据。

以下是 OAuth 在合作伙伴平台上的常见用途示例:

  • 如果您以商家身份创建营业地点,系统就会将商家的 Google 帐号指定为主要所有者。
  • 合作伙伴可以通过平台 API 集成以企业主的身份回复评价并创建帖子。
  • 管理员可通过 API 以企业主的身份进行回复。
  • 商家可以自动将营业地点转移到“Google 我的商家”组织帐号。
  • 自动向帐号或营业地点添加管理员,例如管理员。

    例如,通过使用缓存的 OAuth 2.0 凭据,创建向负责管理的用户的 Google 帐号发出的邀请。然后,负责管理的用户通过缓存的 OAuth 凭据接受邀请。

需要直接由商家操作的例外情况

并非所有操作都可通过使用商家 OAuth 凭据的 API 调用自动执行。

以下是一些需要直接由商家操作的例外情况示例:

  • 商家必须至少登录一次自己的 Google 帐号,让平台缓存 OAuth 凭据,以便之后进行 API 调用以及以商家身份执行操作。
  • 商家必须确认一次 OAuth 2.0 许可征求对话框,这样才能向第三方授予对营业地点数据的访问权限。
  • 商家必须登录自己的 Google 帐号并手动点击某个链接,以启动并完成所有权声明。