Method: accounts.userLinks.batchCreate

Erstellt Informationen über die Verknüpfungen mehrerer Nutzer mit einem Konto oder einer Property.

Diese Methode ist transaktional. Wenn ein UserLink nicht erstellt werden kann, wird keiner der UserLinks erstellt.

HTTP-Anfrage

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

Die URL verwendet die Syntax der gRPC-Transcodierung.

Pfadparameter

Parameter
parent

string

Erforderlich. Das Konto oder die Property, auf die sich alle Nutzerverknüpfungen in der Anfrage beziehen. Dies ist ein Pflichtfeld. Das übergeordnete Feld in „CreateUserLinkRequest“-Nachrichten muss entweder leer sein oder mit diesem Feld übereinstimmen. Beispielformat: accounts/1234

Anfragetext

Der Anfragetext enthält Daten mit folgender Struktur:

JSON-Darstellung 
{
  "notifyNewUsers": boolean,
  "requests": [
    {
      object (CreateUserLinkRequest)
    }
  ]
}
Felder
notifyNewUsers

boolean

Optional. Wenn festgelegt, senden Sie den neuen Nutzern eine E-Mail mit der Benachrichtigung, dass ihnen Berechtigungen für die Ressource gewährt wurden. Unabhängig davon, ob dies festgelegt ist oder nicht, wird das Feld „alertNewUser“ in jeder einzelnen Anfrage ignoriert.
requests[]

object (CreateUserLinkRequest)

Erforderlich. Die Anfragen, in denen die zu erstellenden Nutzerlinks angegeben werden. In einem Batch können maximal 1.000 Nutzerlinks erstellt werden.

Antworttext

Wenn der Vorgang erfolgreich abgeschlossen wurde, enthält der Antworttext eine Instanz von BatchCreateUserLinksResponse.

Autorisierungsbereiche

Erfordert den folgenden OAuth-Bereich:

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

CreateUserLinkRequest

Anfragenachricht für userLinks.create-RPC.

Mit ihrem Google-Konto können mehrere E-Mail-Adressen verknüpft sein. Eine dieser E-Mail-Adressen ist die primäre E-Mail-Adresse. Alle mit einem Google-Konto verknüpften E-Mail-Adressen können für einen neuen UserLink verwendet werden. Der zurückgegebene UserLink enthält jedoch immer die "primäre" E-Mail-Adresse. Daher können sich die Eingabe- und Ausgabe-E-Mail-Adresse für diese Anfrage unterscheiden.

JSON-Darstellung 
{
  "parent": string,
  "notifyNewUser": boolean,
  "userLink": {
    object (UserLink)
  }
}
Felder
parent

string

Erforderlich. Beispielformat: accounts/1234
notifyNewUser

boolean

Optional. Wenn festgelegt, senden Sie dem neuen Nutzer eine E-Mail mit der Benachrichtigung, dass ihm Berechtigungen für die Ressource gewährt wurden.