重要なエンドポイントが無効化される前に、Google Business Profile API 統合をアップデートする必要があります。2022 年 4 月から発生する可能性がある機能中断を避けるため、サポート終了スケジュールと説明を参照しましょう。

REST Resource: accounts.admins

コレクションでコンテンツを整理 必要に応じて、コンテンツの保存と分類を行います。

リソース: Admin

アカウントまたはビジネス情報の管理者。

JSON 表現
{
  "name": string,
  "admin": string,
  "account": string,
  "role": enum (AdminRole),
  "pendingInvitation": boolean
}
フィールド
name

string

不変。リソース名。アカウント管理者の場合は、accounts/{account_id}/admins/{admin_id} の形式になります。

ビジネス管理者の場合は、locations/{locationId}/admins/{admin_id} の形式になります。

管理者の設定時にこのフィールドを設定した場合、このフィールドは無視されます。

admin

string

(省略可)管理者の名前。初回の招待時は、これが招待者のメールアドレスになります。招待が保留中となっている場合、GET の呼び出しでは、ユーザーのメールアドレスが返されます。それ以外の場合は、ユーザーの姓名が含まれます。

このフィールドは、管理者の作成時のみ設定する必要があります。

account

string

不変。この管理者が参照するアカウント リソースの名前。locations.admins.create を呼び出して管理者として LocationGroup を招待するために使用します。

このフィールドと admin の両方が CREATE リクエストに設定されている場合、このフィールドは優先され、admin のメールアドレスは無視されます。

形式: accounts/{account}

role

enum (AdminRole)

必須。この管理者が、指定したアカウントまたはロケーションで使用するロールを指定します。

pendingInvitation

boolean

出力のみ。この管理者が、指定したリソースへの招待を保留にしているかどうかを表します。

管理者ロール

管理者が持っているアクセス権を表します。詳しくは、ヘルプセンターの記事をご覧ください。

列挙型
ADMIN_ROLE_UNSPECIFIED 指定されていません。
PRIMARY_OWNER 管理者はオーナー レベルのアクセス権を持ち、プライマリ オーナーです。(UI では「メインのオーナー」と表示されます)。
OWNER オーナー アクセス権限を持っています。(UI では「オーナー」と表示されます)。
MANAGER 管理者アクセス権限を持っています。
SITE_MANAGER 管理者はソーシャル(Google+)ページを管理できます。(UI では「サイト管理者」と表示されます)。この API では、SITE_MANAGER ロールを持つアカウント管理者を作成することはできません。

Methods

create

指定したユーザーを、指定したアカウントの管理者に招待します。

delete

指定したアカウントから指定した管理者を削除します。

list

指定されたアカウントの管理者を一覧表示します。

patch

指定されたアカウント管理者の管理者を更新します。