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

REST Resource: accounts

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

リソース: Account

アカウントは、ビジネス拠点のコンテナです。ビジネスのビジネス情報を管理するユーザーが他にいない場合は、個人の 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)

組織の追加情報。組織アカウントのみにデータが入力されます。

口座種別

アカウントの種類(個人アカウント、ビジネス アカウント)を示します。

列挙型
ACCOUNT_TYPE_UNSPECIFIED 指定されていません。
PERSONAL エンドユーザー アカウント。
LOCATION_GROUP ビジネス グループ。詳しくは、ヘルプセンターの記事をご覧ください。
USER_GROUP 組織のスタッフをグループに分けるためのユーザー グループ。詳しくは、ヘルプセンターの記事をご覧ください。
ORGANIZATION 会社を表す組織。詳しくは、ヘルプセンターの記事をご覧ください。

アカウントの役割

認証されたユーザーがこのアカウントに対して持っているアクセス権を示します。詳しくは、ヘルプセンターの記事をご覧ください。

列挙型
ACCOUNT_ROLE_UNSPECIFIED 指定されていません。
OWNER ユーザーがこのアカウントのオーナーです。(UI では「メインのオーナー」と表示されます)。
CO_OWNER ユーザーはアカウントの共同オーナーです。(UI では「オーナー」と表示されます)。
MANAGER ユーザーはこのアカウントを管理することができます。
COMMUNITY_MANAGER アカウントのソーシャル(Google+)ページを管理できます。(UI では「サイト管理者」と表示されます)。

アカウントのステータス

アカウントのステータス(Google による確認が完了しているかどうかなど)を示します。

JSON 表現
{
  "status": enum (AccountStatus)
}
フィールド
status

enum (AccountStatus)

オーナー確認を行うと、今後作成されるビジネス情報が自動的に Google マップに接続され、Google+ ページが管理されるようになります。管理は不要です。

アカウントのステータス

アカウントの確認ステータスを示します。

列挙型
ACCOUNT_STATUS_UNSPECIFIED 指定されていません。
VERIFIED 確認済みのアカウント。
UNVERIFIED 未確認のアカウントであり、確認はリクエストされていません。
VERIFICATION_REQUESTED アカウントは確認されていませんが、確認がリクエストされています。

権限レベル

認証されたユーザーがこのアカウントに対して持っているアクセス権を示します。

列挙型
PERMISSION_LEVEL_UNSPECIFIED 指定されていません。
OWNER_LEVEL ユーザーにオーナーレベルの権限がある。
MEMBER_LEVEL ユーザーがメンバーレベルの権限を持っている。

組織情報

組織について保存された追加情報。

JSON 表現
{
  "registeredDomain": string,
  "postalAddress": {
    object (PostalAddress)
  },
  "phoneNumber": string
}
フィールド
registeredDomain

string

アカウントの登録済みドメイン。

postalAddress

object (PostalAddress)

アカウントの住所。

phoneNumber

string

組織の連絡先電話番号。

Methods

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 通知設定を行います。

  • ビジネスが管理しているビジネスの新しいクチコミ。