- HTTP-Anfrage
- Pfadparameter
- Anfragetext
- Antworttext
- Autorisierungsbereiche
- CreateUserLinkRequest
- Testen!
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 |
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 ( |
Felder | |
---|---|
notifyNewUsers |
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[] |
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 ( |
Felder | |
---|---|
parent |
Erforderlich. Beispielformat: accounts/1234 |
notifyNewUser |
Optional. Wenn festgelegt, senden Sie dem neuen Nutzer eine E-Mail mit der Benachrichtigung, dass ihm Berechtigungen für die Ressource gewährt wurden. |
userLink |
Erforderlich. Der Nutzerlink, der erstellt werden soll. |