Method: accounts.userLinks.batchCreate

Crea informazioni sui collegamenti di più utenti a un account o a una proprietà.

Questo metodo è transazionale. Se non è possibile creare uno UserLink, non verrà creato nessuno degli UserLink.

Richiesta HTTP

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

L'URL utilizza la sintassi di transcodifica gRPC.

Parametri del percorso

Parametri
parent

string

Obbligatoria. L'account o la proprietà a cui sono collegati tutti gli utenti nella richiesta. Questo campo è obbligatorio. Il campo principale nei messaggi CreateUserLinkRequest deve essere vuoto o corrispondere a questo campo. Formato di esempio: accounts/1234

Corpo della richiesta

Il corpo della richiesta contiene dati con la seguente struttura:

Rappresentazione JSON 
{
  "notifyNewUsers": boolean,
  "requests": [
    {
      object (CreateUserLinkRequest)
    }
  ]
}
Campi
notifyNewUsers

boolean

Campo facoltativo. Se impostato, invia un'email ai nuovi utenti informandoli che hanno ricevuto le autorizzazioni per la risorsa. Indipendentemente dal fatto che sia impostato o meno, il campo notificationNewUser all'interno di ogni singola richiesta viene ignorato.
requests[]

object (CreateUserLinkRequest)

Obbligatoria. Le richieste che specificano i collegamenti dell'utente da creare. È possibile creare un massimo di 1000 collegamenti utente in un batch.

Corpo della risposta

In caso di esito positivo, il corpo della risposta contiene un'istanza di BatchCreateUserLinksResponse.

Ambiti di autorizzazione

Richiede il seguente ambito OAuth:

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

CreateUserLinkRequest

Messaggio di richiesta per la RPC userLinks.create.

Gli utenti possono avere più indirizzi email associati al proprio Account Google e uno di questi indirizzi email è l'indirizzo "principale". Qualsiasi indirizzo email associato a un Account Google può essere utilizzato per un nuovo UserLink, ma lo UserLink restituito conterrà sempre l'indirizzo email "principale". Di conseguenza, gli indirizzi email di input e di output di questa richiesta potrebbero essere diversi.

Rappresentazione JSON 
{
  "parent": string,
  "notifyNewUser": boolean,
  "userLink": {
    object (UserLink)
  }
}
Campi
parent

string

Obbligatoria. Formato di esempio: accounts/1234
notifyNewUser

boolean

Campo facoltativo. Se impostato, invia un'email al nuovo utente per informarlo che ha ricevuto le autorizzazioni per la risorsa.