Method: accounts.userLinks.batchCreate

Crée des informations sur les associations de plusieurs utilisateurs à un compte ou à une propriété.

Cette méthode est transactionnelle. Si un UserLink ne peut pas être créé, aucun des UserLinks ne sera créé.

Requête HTTP

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

L'URL utilise la syntaxe de transcodage gRPC.

Paramètres de chemin d'accès

Paramètres
parent

string

Obligatoire. Compte ou propriété associés à tous les liens utilisateur dans la demande. Ce champ est obligatoire. Le champ parent des messages CreateUserLinkRequest doit être vide ou correspondre à ce champ. Exemple de format: accounts/1234

Corps de la requête

Le corps de la requête contient des données présentant la structure suivante :

Représentation JSON
{
  "notifyNewUsers": boolean,
  "requests": [
    {
      object (CreateUserLinkRequest)
    }
  ]
}
Champs
notifyNewUsers

boolean

Facultatif. Si cette option est définie, envoyez un e-mail aux nouveaux utilisateurs pour les informer qu'ils ont accès à la ressource. Que cette règle soit définie ou non, le champ " informNewUser" de chaque requête est ignoré.

requests[]

object (CreateUserLinkRequest)

Obligatoire. Requêtes spécifiant les liens utilisateur à créer. Vous pouvez créer jusqu'à 1 000 associations utilisateur par lot.

Corps de la réponse

Si la requête aboutit, le corps de la réponse contient une instance de BatchCreateUserLinksResponse.

Champs d'application des autorisations

Requiert le niveau d'accès OAuth suivant :

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

CreateUserLinkRequest

Message de requête pour le RPC userLinks.create.

Les utilisateurs peuvent avoir plusieurs adresses e-mail associées à leur compte Google, l'une de ces adresses étant l'adresse e-mail principale. Toutes les adresses e-mail associées à un compte Google peuvent être utilisées pour un nouveau UserLink, mais le UserLink renvoyé contiendra toujours l'adresse e-mail "principale". Par conséquent, les adresses e-mail d'entrée et de sortie de cette requête peuvent être différentes.

Représentation JSON
{
  "parent": string,
  "notifyNewUser": boolean,
  "userLink": {
    object (UserLink)
  }
}
Champs
parent

string

Obligatoire. Exemple de format: accounts/1234

notifyNewUser

boolean

Facultatif. Si cette option est définie, envoyez un e-mail au nouvel utilisateur pour l'informer qu'il a obtenu des autorisations pour la ressource.