Method: accounts.invitations.list

列出指定帳戶的待回覆邀請。

HTTP 要求

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

這個網址使用 gRPC 轉碼語法。

路徑參數

參數
parent

string

必要欄位。擷取邀請清單的帳戶名稱。accounts/{account_id}/invitations

查詢參數

參數
filter

string

選用設定。您可以透過 邀請.target_type 欄位篩選回應。

要求主體

要求主體必須為空白。

回應主體

AccessControl.List 邀請 s 的回應訊息。

如果成功，回應主體即會包含具有以下結構的資料：

JSON 表示法 
{
  "invitations": [
    {
      object (Invitation)
    }
  ]
}
欄位
invitations[]

object (Invitation)

帳戶中待處理的邀請。這裡列出的邀請數不得超過 1000。

授權範圍

需要下列 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 僅列出「地區」類型的邀請。