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)

组织的其他信息。系统只会为组织帐号填充此字段。

AccountType

表明帐号类型:个人/用户帐号或企业帐号。

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

AccountRole

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

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

AccountState

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

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

enum (AccountStatus)

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

AccountStatus

指明帐号的验证状态。

枚举
ACCOUNT_STATUS_UNSPECIFIED 未指定。
VERIFIED 经过验证的账号。
UNVERIFIED 账号未经过验证,也未请求验证。
VERIFICATION_REQUESTED 未验证,但已请求验证的账号。

PermissionLevel

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

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

OrganizationInfo

为组织存储的其他信息。

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)

返回帐号的 PubSub 通知设置。

list
(deprecated)

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

listRecommendGoogleLocations

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

update
(deprecated)

更新指定的商家帐号。

updateNotifications
(deprecated)

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

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