使用账号数据

本教程介绍了如何使用账号数据。借助 My Business Account Management API，您可以执行以下操作：

• 列出所有账号。
• 返回特定账号。
• 更新账号。

准备工作

在使用 My Business Account Management API 之前，您需要注册您的应用并获取 OAuth 2.0 凭据。

如需详细了解如何开始使用 Business Profile API，请参阅基本设置。

列出所有账号

要验证与经过身份验证的用户关联的账号，一个好方法是列出其所有账号。使用 accounts.list API 可列出与某个用户关联的所有账号。

要列出经过身份验证的用户的所有账号，请使用以下命令：

$ GET https://mybusinessaccountmanagement.googleapis.com/v1/accounts

返回特定账号

有时，您只需要查看与经过身份验证的用户的特定账号相关的信息。使用 accounts.get API 可返回特定账号并查看其他账号详情。

要按名称返回特定账号，请使用以下命令：

$ GET https://mybusinessaccountmanagement.googleapis.com/v1/accounts/{accountId}

更新账号

更改账号名称是一项基本的管理任务。使用 accounts.update API 可更改账号名称。

要按名称更新特定账号，请使用以下命令：

$ PUT https://mybusinessaccountmanagement.googleapis.com/v1/accounts/{accountId}

{
  "account": {
    "accountName": "Anne Droyd"
  },
  "languageCode": "en",
  "validateOnly": "true"
}

限制

• 账号中唯一可修改的字段是 accountName。传递的其他任何字段都会被忽略。
• 只有 BUSINESS 类型的账号才能采用这种方式进行更新。