使用帐号数据

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

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

准备工作

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

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

列出所有账号

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

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

HTTP

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

返回特定账号

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

如需按名称返回特定帐号，请使用以下命令：

HTTP

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

更新帐号

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

如需按名称更新特定帐号，请使用以下命令：

HTTP

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

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

限制

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