使用帳戶資料

本教學課程說明如何處理帳戶資料。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 類型的帳戶。