Method: accounts.userLinks.batchCreate

Cria informações sobre as vinculações de vários usuários a uma conta ou propriedade.

Esse método é transacional. Se não for possível criar um UserLink, nenhum dos UserLinks será criado.

Solicitação HTTP

POST https://analyticsadmin.googleapis.com/v1alpha/{parent=accounts/*}/userLinks:batchCreate

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

Parâmetros de caminho

Parâmetros
parent

string

Obrigatório. A conta ou propriedade a que todos os usuários vinculam na solicitação. Este campo é obrigatório. O campo pai nas mensagens CreateUserLinkRequest precisa estar vazio ou corresponder a esse campo. Exemplo de formato: accounts/1234

Corpo da solicitação

O corpo da solicitação contém dados com a seguinte estrutura:

Representação JSON 
{
  "notifyNewUsers": boolean,
  "requests": [
    {
      object (CreateUserLinkRequest)
    }
  ]
}
Campos
notifyNewUsers

boolean

Opcional. Se definido, envie um e-mail aos novos usuários notificando que eles receberam permissões para o recurso. Independentemente de estar definido ou não, o campo "notificationsNewUser" dentro de cada solicitação individual é ignorado.
requests[]

object (CreateUserLinkRequest)

Obrigatório. As solicitações que especificam os links de usuário a serem criados. Até 1.000 links de usuário podem ser criados em um lote.

Corpo da resposta

Se a solicitação for bem-sucedida, o corpo da resposta conterá uma instância de BatchCreateUserLinksResponse.

Escopos de autorização

Requer o seguinte escopo OAuth:

  • https://www.googleapis.com/auth/analytics.manage.users

CreateUserLinkRequest

Mensagem de solicitação para a RPC userLinks.create.

Os usuários podem ter vários endereços de e-mail associados à Conta do Google, e um desses endereços é o "principal". Qualquer um dos endereços de e-mail associados a uma Conta do Google pode ser usado para um novo UserLink, mas o UserLink retornado sempre conterá o endereço de e-mail "principal". Como resultado, os endereços de e-mail de entrada e saída dessa solicitação podem ser diferentes.

Representação JSON 
{
  "parent": string,
  "notifyNewUser": boolean,
  "userLink": {
    object (UserLink)
  }
}
Campos
parent

string

Obrigatório. Exemplo de formato: accounts/1234
notifyNewUser

boolean

Opcional. Se definido, envie um e-mail ao novo usuário notificando que ele recebeu permissões para o recurso.