REST Resource: accounts

資源：帳戶

帳戶是商家地點的容器，如果您是唯一負責管理商家營業地點的使用者，可以使用個人 Google 帳戶。如要與多位使用者共同管理地點，請建立商家帳戶。

JSON 表示法 
{
  "name": string,
  "accountName": string,
  "type": enum (AccountType),
  "role": enum (AccountRole),
  "state": {
    object (AccountState)
  },
  "accountNumber": string,
  "permissionLevel": enum (PermissionLevel),
  "organizationInfo": {
    object (OrganizationInfo)
  }
}
欄位
name

string

資源名稱，格式為 accounts/{accountId}。
accountName

string

帳戶名稱。
type

enum (AccountType)

僅供輸出。指定這個帳戶的AccountType。
role

enum (AccountRole)

僅供輸出。指定呼叫端對此帳戶擁有的 AccountRole。
state

object (AccountState)

僅供輸出。指出這個帳戶的AccountState。
accountNumber

string

帳戶參考號碼 (如有佈建)。
permissionLevel

enum (PermissionLevel)

僅供輸出。指定呼叫端對此帳戶擁有的 PermissionLevel。
organizationInfo

object (OrganizationInfo)

機構的其他資訊。僅針對機構帳戶填入資料。

AccountType

表示這個帳戶的類型：個人帳戶/使用者帳戶或企業帳戶。

列舉
ACCOUNT_TYPE_UNSPECIFIED 不指定。
PERSONAL 使用者帳戶。
LOCATION_GROUP 一組營業地點。詳情請參閱說明中心文章
USER_GROUP 使用群組來區隔機構員工的使用者。詳情請參閱說明中心文章
ORGANIZATION 代表公司的機構。詳情請參閱說明中心文章

AccountRole

指出已驗證使用者對這個帳戶的存取層級。詳情請參閱說明中心文章

列舉
ACCOUNT_ROLE_UNSPECIFIED 不指定。
OWNER 使用者是這個帳戶的擁有者。(在 UI 中顯示為「主要擁有者」)。
CO_OWNER 使用者是帳戶的共同擁有者。(在 UI 中顯示為「擁有者」)。
MANAGER 使用者可以管理這個帳戶。
COMMUNITY_MANAGER 使用者可以管理帳戶的社交 (Google+) 專頁。(在使用者介面中顯示為「網站管理員」。

AccountState

指出帳戶狀態，例如帳戶是否已經過 Google 驗證。

JSON 表示法 
{
  "status": enum (AccountStatus)
}
欄位
status

enum (AccountStatus)

驗證完成後，新建立的地點會自動與 Google 地圖連結，並建立 Google+ 專頁，不需進行審核。

AccountStatus

指出帳戶的驗證狀態。

列舉
ACCOUNT_STATUS_UNSPECIFIED 不指定。
VERIFIED 帳戶已完成驗證。
UNVERIFIED 帳戶未經驗證，也未要求驗證。
VERIFICATION_REQUESTED 帳戶未經驗證，但已要求驗證。

PermissionLevel

指出已驗證使用者對這個帳戶的存取層級。

列舉
PERMISSION_LEVEL_UNSPECIFIED 不指定。
OWNER_LEVEL 使用者俱備擁有者層級權限。
MEMBER_LEVEL 使用者俱備成員層級權限。

OrganizationInfo

為機構儲存的其他資訊。

JSON 表示法 
{
  "registeredDomain": string,
  "postalAddress": {
    object (PostalAddress)
  },
  "phoneNumber": string
}
欄位
registeredDomain

string

帳戶的註冊網域。
postalAddress

object (PostalAddress)

帳戶的郵寄地址。
phoneNumber

string

機構的聯絡電話。

方法

create
(deprecated)

 以指定的名稱建立帳戶，並在指定父項底下輸入。

deleteNotifications
(deprecated)

 清除帳戶的 Pub/Sub 通知設定。

generateAccountNumber
(deprecated)

 為這個帳戶產生帳號。

get
(deprecated)

 取得指定帳戶。

getNotifications
(deprecated)

 傳回帳戶的 Pub/Sub 通知設定。

list
(deprecated)

 列出已驗證使用者的所有帳戶。

listRecommendGoogleLocations

 列出提供給指定商家檔案帳戶的所有GoogleLocation。

update
(deprecated)

 更新指定的商家帳戶。

updateNotifications
(deprecated)

為帳戶進行 Pub/Sub 通知設定，通知商家檔案要針對哪項主題傳送 Pub/Sub 通知：

  • 針對帳戶管理的地點所發布的新評論。