Method: accounts.invitations.list

Lista os convites pendentes para a conta especificada.

Solicitação HTTP

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

O URL usa a sintaxe de transcodificação gRPC.

Parâmetros de caminho

Parâmetros
parent

string

Obrigatório. O nome da conta da qual a lista de convites está sendo recuperada. accounts/{account_id}/invitations

Parâmetros de consulta

Parâmetros
filter

string

Opcional. A filtragem da resposta é suportada pelo campo Invitation.target_type.

Corpo da solicitação

O corpo da solicitação precisa estar vazio.

Corpo da resposta

Mensagem de resposta para AccessControl.ListInvitations.

Se bem-sucedido, o corpo da resposta incluirá dados com a estrutura a seguir:

Representação JSON
{
  "invitations": [
    {
      object (Invitation)
    }
  ]
}
Campos
invitations[]

object (Invitation)

Um conjunto de convites pendentes na conta. O número de convites listados aqui não pode exceder 1.000.

Escopos de autorização

Requer o seguinte escopo OAuth:

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

Para mais informações, consulte a Visão geral do OAuth 2.0.

Convite

Representa um convite pendente.

Representação 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.
}
Campos
name

string

Obrigatório. O nome do recurso do convite. accounts/{account_id}/invitations/{invitation_id}.

role

enum (AdminRole)

Apenas saída. A função convidada na conta.

targetType

enum (TargetType)

Apenas saída. Especifica quais tipos de destino devem aparecer na resposta.

Campo de união target. Indica o alvo do convite. target pode ser apenas de um dos tipos a seguir:
targetAccount

object (Account)

A conta com pouco preenchimento.

targetLocation

object (TargetLocation)

O local de segmentação para o qual este convite se destina.

TargetLocation

Representa uma região de segmentação para um convite pendente.

Representação JSON
{
  "locationName": string,
  "address": string
}
Campos
locationName

string

O nome do local para o qual o usuário é convidado.

address

string

O endereço do local para o qual o usuário foi convidado.

Tipo de segmentação

O tipo de destino ao qual um convite se destina.

Enums
TARGET_TYPE_UNSPECIFIED Definido quando o tipo de destino não é especificado.
ACCOUNTS_ONLY Listar convites apenas para segmentações do tipo "Account".
LOCATIONS_ONLY Listar convites apenas para segmentações do tipo "Local".