Method: properties.userLinks.batchCreate

Erstellt Informationen zu den Verknüpfungen mehrerer Nutzer zu einem Konto oder einer Property.

Diese Methode ist transaktional. Wenn kein UserLink erstellt werden kann, wird auch keiner erstellt.

HTTP-Anfrage

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

Die URL verwendet die Syntax der gRPC-Transcodierung.

Pfadparameter

Parameter
parent

string

Erforderlich. Das Konto oder die Property, für die alle Nutzerlinks in der Anfrage bestimmt sind. Dies ist ein Pflichtfeld. Das übergeordnete Feld in den „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. Falls die Einstellung festgelegt ist, senden Sie den neuen Nutzern per E-Mail eine Benachrichtigung, dass ihnen Berechtigungen für die Ressource gewährt wurden. Unabhängig davon, ob dies festgelegt ist oder nicht, wird das Feld „NewNewUser“ in jeder einzelnen Anfrage ignoriert.

requests[]

object (CreateUserLinkRequest)

Erforderlich. Die Anfragen, in denen die zu erstellenden Nutzerlinks angegeben sind. 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