- Solicitação HTTP
- Parâmetros de caminho
- Corpo da solicitação
- Corpo da resposta
- Escopos da autorização
- CreateUserLinkRequest
- Faça um teste
Cria informações sobre vários usuários (links para uma conta ou propriedade).
Esse método é transacional. Se nenhum UserLink não puder ser criado, nenhum dos links de usuário 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 |
Obrigatório. Conta ou propriedade vinculada a todos os links de usuários na solicitação. Este campo é obrigatório. O campo pai nas mensagens CreateUserLinkRequest precisa estar vazio ou corresponder a este 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 ( |
Campos | |
---|---|
notifyNewUsers |
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 notificationNewUser em cada solicitação individual será ignorado. |
requests[] |
Obrigatório. As solicitações que especificam os links de usuário a serem criados. É possível criar no máximo mil links de usuário 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 CreateUserLink.
Os usuários podem ter vários endereços de e-mail associados à Conta do Google deles, e um deles é o e-mail 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 "primary" Como resultado, os endereços de e-mail de entrada e saída para a solicitação podem ser diferentes.
Representação JSON |
---|
{
"parent": string,
"notifyNewUser": boolean,
"userLink": {
object ( |
Campos | |
---|---|
parent |
Obrigatório. Exemplo de formato: accounts/1234 |
notifyNewUser |
Opcional. Se definido, envie um e-mail ao novo usuário notificando que ele recebeu permissões para o recurso. |
userLink |
Obrigatório. O link de usuário a ser criado. |