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 alcun link utente.

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

Obbligatorio. L'account o la proprietà a cui si riferiscono 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 per informarli 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)

Obbligatorio. Le richieste che specificano i collegamenti utente da creare. È possibile creare un massimo di 1000 collegamenti utente in un gruppo.

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 l'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, l'indirizzo email di input e quello di output per questa richiesta potrebbero essere diversi.

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

string

Obbligatorio. Formato di esempio: accounts/1234

notifyNewUser

boolean

Campo facoltativo. Se è impostata, invia un'email al nuovo utente per informarlo che gli sono state concesse le autorizzazioni per la risorsa.