Google Business Performance API 的新 API 方法可通过单个 API 请求提取多个 `DailyMetrics`。
请查看弃用时间表和相关说明，并从 v4 reportInsights API 方法迁移至 Google Business Profile Performance API。

此页面由 Cloud Translation API 翻译。

REST Resource: accounts

资源：Account <ph type="x-smartling-placeholder">
- JSON 表示法
AccountType
AccountRole
VerificationState
VettedState
PermissionLevel
OrganizationInfo <ph type="x-smartling-placeholder">
- JSON 表示法
PostalAddress <ph type="x-smartling-placeholder">
- JSON 表示法
方法

资源：Account

账号是营业地点的容器。如果您是唯一一位负责管理您商家营业地点的用户，则可以使用自己的个人 Google 账号。要与多个用户共享营业地点的管理权限，请创建一个商家账号。

JSON 表示法

JSON 表示法
{ "name": string, "accountName": string, "primaryOwner": string, "type": enum (`AccountType`), "role": enum (`AccountRole`), "verificationState": enum (`VerificationState`), "vettedState": enum (`VettedState`), "accountNumber": string, "permissionLevel": enum (`PermissionLevel`), "organizationInfo": { object (`OrganizationInfo`) } }

{
  "name": string,
  "accountName": string,
  "primaryOwner": string,
  "type": enum (AccountType),
  "role": enum (AccountRole),
  "verificationState": enum (VerificationState),
  "vettedState": enum (VettedState),
  "accountNumber": string,
  "permissionLevel": enum (PermissionLevel),
  "organizationInfo": {
    object (OrganizationInfo)
  }
}

字段
`name`	`string` 不可变。资源名称，格式为 `accounts/{account_id}`。
`accountName`	`string` 必需。账号名称。对于 `PERSONAL` 类型的账号，这是用户账号的名字和姓氏。
`primaryOwner`	`string` 必需。仅限输入。账号的资源名称，该账号将是所创建账号的主要所有者。其格式应为 `accounts/{account_id}`。
`type`	`enum (AccountType)` 必需。包含账号类型。无法使用此 API 创建 PERSONAL 和 ORGANIZATION 类型的账号。
`role`	`enum (AccountRole)` 仅限输出。指定此账号的 AccountRole。
`verificationState`	`enum (VerificationState)` 仅限输出。如果通过验证，则今后创建的地点信息会自动与 Google 地图相关联，并创建 Google+ 信息页，而无需进行审核。
`vettedState`	`enum (VettedState)` 仅限输出。指明账号是否经过 Google 审核。经过审核的账号能够通过 VETTED_PARTNER 方法验证营业地点。
`accountNumber`	`string` 仅限输出。账号参考号（如果已配置）。
`permissionLevel`	`enum (PermissionLevel)` 仅限输出。指定用户对此账号的权限级别。
`organizationInfo`	`object (OrganizationInfo)` 仅限输出。组织的其他信息。系统只会为组织账号填充此字段。

AccountType

表明这是哪类账号：个人/用户账号还是企业账号。

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

AccountRole

指明通过身份验证的用户对此账号拥有的访问权限级别。如需了解详情，请参阅帮助中心文章

枚举
`ACCOUNT_ROLE_UNSPECIFIED`	未指定。
`PRIMARY_OWNER`	该用户是此账号的主要所有者。
`OWNER`	账号的用户所有者。
`MANAGER`	用户可以管理此账号。
`SITE_MANAGER`	用户可以为该账号管理有限的功能。

VerificationState

指示账号的验证状态。

枚举
`VERIFICATION_STATE_UNSPECIFIED`	未指定。
`VERIFIED`	账号已通过验证。
`UNVERIFIED`	账号未通过验证，且尚未请求验证。
`VERIFICATION_REQUESTED`	账号未经验证，但已请求验证。

VettedState

表示账号的审核状态。

枚举
`VETTED_STATE_UNSPECIFIED`	未指定
`NOT_VETTED`	此账号未经过 Google 审核。
`VETTED`	账号已通过 Google 的审核，且处于有效状态。如果某个账号可以直接访问经过审核的群组账号，则该账号会自动接受审核。
`INVALID`	账号已通过审核，但处于无效状态。该账号的行为与未经审查的账号类似。

PermissionLevel

指明通过身份验证的用户对此账号拥有的访问权限级别。

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

OrganizationInfo

为组织存储的其他信息。

JSON 表示法
{ "registeredDomain": string, "address": { object (`PostalAddress`) }, "phoneNumber": string }

字段

字段
`registeredDomain`	`string` 仅限输出。账号的注册域名。
`address`	`object (PostalAddress)` 仅限输出。账号的邮政地址。
`phoneNumber`	`string` 仅限输出。组织的联系电话。

registeredDomain

string

仅限输出。账号的注册域名。

address

object (PostalAddress)

仅限输出。账号的邮政地址。

phoneNumber

string

仅限输出。组织的联系电话。

PostalAddress

表示邮政地址，例如邮政递送或付款地址。给定邮政地址时，邮政服务可以将物品投递到处所、邮政信箱或其他投递地点。此对象不模拟地理位置（道路、城镇、山区）。

在典型的使用场景中，地址将通过用户输入或导入现有数据来创建，具体取决于进程的类型。

有关输入/修改地址的建议：- 使用支持国际化的地址微件，例如 https://github.com/google/libaddressinput。不应向用户显示用于输入或修改该字段的其他国家/地区对应的界面元素。

如需详细了解如何使用此架构，请参阅：https://support.google.com/business/answer/6397478

JSON 表示法
{ "revision": integer, "regionCode": string, "languageCode": string, "postalCode": string, "sortingCode": string, "administrativeArea": string, "locality": string, "sublocality": string, "addressLines": [ string ], "recipients": [ string ], "organization": string }