使用帐号数据

本教程介绍了如何使用账号数据。借助 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 类型的账号才能采用这种方式进行更新。