REST Resource: accounts

资源:Account

账号是用来存放营业地点的容器。如果您是唯一一位负责管理您商家营业地点的用户,则可以使用自己的个人 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 通知:

  • 针对该账号所管理的营业地点的新评价。