Method: accounts.invitations.list

指定したアカウントについて、承認待ちとなっている招待の一覧を取得します。

HTTP リクエスト

GET https://mybusinessaccountmanagement.googleapis.com/v1/{parent=accounts/*}/invitations

この URL は gRPC Transcoding 構文を使用します。

パスパラメータ

パラメータ
parent

string

必須。招待のリストを取得するアカウントの名前です。accounts/{account_id}/invitations

クエリ パラメータ

パラメータ
filter

string

省略可。レスポンスのフィルタリングは、Invite.target_type フィールドでサポートされます。

リクエスト本文

リクエストの本文は空にする必要があります。

レスポンスの本文

AccessControl.ListInvites に対するレスポンス メッセージです。

成功した場合、レスポンスの本文には次の構造のデータが含まれます。

JSON 表現 
{
  "invitations": [
    {
      object (Invitation)
    }
  ]
}
フィールド
invitations[]

object (Invitation)

アカウントで保留になっている招待の集まりです。ここに表示される招待の数は 1,000 以下にしてください。

認可スコープ

次の OAuth スコープが必要です。

  • https://www.googleapis.com/auth/business.manage

詳しくは、OAuth 2.0 の概要をご覧ください。

招待

保留中の招待を表します。

JSON 表現 
{
  "name": string,
  "role": enum (AdminRole),
  "targetType": enum (TargetType),

  // Union field target can be only one of the following:
  "targetAccount": {
    object (Account)
  },
  "targetLocation": {
    object (TargetLocation)
  }
  // End of list of possible types for union field target.
}
フィールド
name

string

必須。招待状のリソース名。accounts/{account_id}/invitations/{invitation_id}。
role

enum (AdminRole)

出力専用。アカウントに対する招待されたロール。
targetType

enum (TargetType)

出力専用。レスポンスに表示するターゲット タイプを指定します。
共用体フィールド target。この招待のターゲットを示します。target は次のいずれかになります。
targetAccount

object (Account)

この招待の対象となる、データがわずかに入力されているアカウント。
targetLocation

object (TargetLocation)

この招待の対象地域。

TargetLocation

保留中の招待の対象地域を表します。

JSON 表現 
{
  "locationName": string,
  "address": string
}
フィールド
locationName

string

ユーザーが招待されているビジネスの名前。
address

string

ユーザーが招待されているビジネスの住所。

TargetType

招待の対象となるターゲットのタイプ。

列挙型
TARGET_TYPE_UNSPECIFIED ターゲット タイプが指定されていない場合に設定されます。
ACCOUNTS_ONLY アカウント タイプの招待のみをリストします。
LOCATIONS_ONLY Location タイプの招待のみを一覧表示します。