Business Profile Performance API 现已发布!必须执行迁移工作。
查看弃用时间表以及相关说明,了解如何从旧版 v4 API 迁移到新的 v1 API。
请填写此调查问卷,帮助我们更好地了解您支持哪些商家的地点、菜单和菜品属性,从而帮助我们改善食品菜单体验

REST Resource: accounts

使用集合让一切井井有条 根据您的偏好保存内容并对其进行分类。

资源:帐号

帐号是存储营业地点的容器。如果您是商家的唯一营业地点管理者,则可以使用个人 Google 帐号。要与多个用户共享营业地点的管理权限,请创建商家帐号

JSON 表示法
{
  "name": string,
  "accountName": string,
  "type": enum (AccountType),
  "role": enum (AccountRole),
  "state": {
    object (AccountState)
  },
  "accountNumber": string,
  "permissionLevel": enum (PermissionLevel),
  "organizationInfo": {
    object (OrganizationInfo)
  }
}
字段
name

string

资源名称,格式为 accounts/{accountId}

accountName

string

帐号的名称。

type

enum (AccountType)

仅供输出。指定此帐号的AccountType

role

enum (AccountRole)

仅供输出。为调用方指定此帐号的 AccountRole

state

object (AccountState)

仅供输出。表示此帐号的AccountState

accountNumber

string

帐号参考号(如果已配置)。

permissionLevel

enum (PermissionLevel)

仅供输出。为调用方指定此帐号的 PermissionLevel

organizationInfo

object (OrganizationInfo)

组织的其他信息。系统仅为组织帐号填充。

帐号类型

表明这是一个哪种帐号:个人/用户帐号或企业帐号。

枚举
ACCOUNT_TYPE_UNSPECIFIED 未指定。
PERSONAL 最终用户帐号。
LOCATION_GROUP 一组营业地点。如需了解详情,请参阅这篇帮助中心文章
USER_GROUP 用于将用户归入群组的群组中的群组。如需了解详情,请参阅这篇帮助中心文章
ORGANIZATION 代表公司的组织。如需了解详情,请参阅这篇帮助中心文章

帐号角色

表示经过身份验证的用户对此帐号的访问权限级别。如需了解详情,请参阅这篇帮助中心文章

枚举
ACCOUNT_ROLE_UNSPECIFIED 未指定。
OWNER 此帐号归该用户所有。(在界面中显示为“主要所有者”。
CO_OWNER 该用户是该帐号的共同所有者。(在界面中显示为“所有者”)。
MANAGER 用户可以管理此帐号。
COMMUNITY_MANAGER 用户可以管理帐号的社交 (Google+) 页面。(在界面中显示为“营业地点管理员”)。

帐号状态

指明帐号的状态,例如相应帐号是否已经过 Google 验证。

JSON 表示法
{
  "status": enum (AccountStatus)
}
字段
status

enum (AccountStatus)

如果通过验证,日后创建的营业地点会自动与 Google 地图相关联,并且创建了 Google+ 信息页,而无需进行审核。

帐号状态

指明帐号的验证状态。

枚举
ACCOUNT_STATUS_UNSPECIFIED 未指定。
VERIFIED 已通过验证的帐号。
UNVERIFIED 未验证且尚未申请验证的帐号。
VERIFICATION_REQUESTED 尚未验证但已请求验证的帐号。

权限级别

表示经过身份验证的用户对此帐号的访问权限级别。

枚举
PERMISSION_LEVEL_UNSPECIFIED 未指定。
OWNER_LEVEL 用户拥有所有者级别权限。
MEMBER_LEVEL 用户拥有成员级权限。

组织信息

为组织存储的其他信息。

JSON 表示法
{
  "registeredDomain": string,
  "postalAddress": {
    object (PostalAddress)
  },
  "phoneNumber": string
}
字段
registeredDomain

string

帐号的注册域名。

postalAddress

object (PostalAddress)

帐号的邮政地址。

phoneNumber

string

相应组织的联系电话号码。

方法

create
(deprecated)

在指定父级下创建具有指定名称和类型的帐号。

deleteNotifications
(deprecated)

清除帐号的 PubSub 通知设置。

generateAccountNumber
(deprecated)

为此帐号生成帐号。

get
(deprecated)

获取指定的帐号。

getNotifications
(deprecated)

返回帐号的 Pub 通知设置。

list
(deprecated)

列出经过身份验证的用户的所有帐号。

listRecommendGoogleLocations

列出已推荐到指定商家资料帐号的所有GoogleLocation

update
(deprecated)

更新指定的商家帐号。

updateNotifications
(deprecated)

为帐号指定 Pub 通知设置,以告知商家资料要为哪个主题发送 Pub 通知:

  • 由该帐号管理的营业地点的新评价。