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