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 中會顯示為「Owner」)。
MANAGER 使用者可以管理這個帳戶。
COMMUNITY_MANAGER 使用者可以管理帳戶的社交 (Google+) 專頁。(在使用者介面中顯示為「Site Manager」)。

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 通知：

  • 針對這個帳戶所管理營業地點的新評論。