- 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 den CreateUserLinkRequest-Nachrichten muss entweder leer sein oder diesem Feld entsprechen. Beispielformat: accounts/1234 |
Anfragetext
Der Anfragetext enthält Daten mit folgender Struktur:
JSON-Darstellung |
---|
{
"notifyNewUsers": boolean,
"requests": [
{
object ( |
Felder | |
---|---|
notifyNewUsers |
Optional. Wenn festgelegt, werden die neuen Nutzer per E-Mail darüber benachrichtigt, dass ihnen Berechtigungen für die Ressource gewährt wurden. Unabhängig davon, ob dies festgelegt ist oder nicht, wird das Feld „NotifyNewUser“ in jeder einzelnen Anfrage ignoriert. |
requests[] |
Erforderlich. Die Anfragen, in denen die zu erstellenden Nutzerlinks angegeben werden. Es können maximal 1.000 Nutzerlinks im Batch 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. Jede mit einem Google-Konto verknüpfte E-Mail-Adresse kann 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, wird der neue Nutzer per E-Mail darüber benachrichtigt, dass ihm Berechtigungen für die Ressource gewährt wurden. |
userLink |
Erforderlich. Der Nutzerlink, der erstellt werden soll. |