使用帳戶資料

本教學課程將說明如何使用帳戶資料。My Business Account Management API 可讓您執行下列操作:

  • 列出所有帳戶。
  • 傳回特定帳戶。
  • 更新帳戶。

事前準備

使用「我的商家帳戶管理」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 類型的帳戶可以以這種方式更新。