本教學課程說明如何使用帳戶資料。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
類型的帳戶能以這種方式更新。