יצירת מידע על קישורים של כמה משתמשים לחשבון או לנכס.
השיטה הזו מיועדת לטרנזקציות. אם לא ניתן ליצור UserLink כלשהו, לא ייווצר אף UserLink.
בקשת HTTP
POST https://analyticsadmin.googleapis.com/v1alpha/{parent=accounts/*}/userLinks:batchCreate
בכתובת ה-URL נעשה שימוש בתחביר המרת קידוד של gRPC.
פרמטרים של נתיב
פרמטרים | |
---|---|
parent |
חובה. החשבון או הנכס שעבורם נכללים כל קישורי המשתמשים בבקשה. חובה לבחור אפשרות לשדה הזה. שדה ההורה בהודעות CreateUserLinkRequest חייב להיות ריק או להתאים לשדה זה. פורמט לדוגמה: accounts/1234 |
גוף הבקשה
גוף הבקשה מכיל נתונים במבנה הבא:
ייצוג JSON |
---|
{
"notifyNewUsers": boolean,
"requests": [
{
object ( |
שדות | |
---|---|
notifyNewUsers |
זה שינוי אופציונלי. אם היא מוגדרת, שולחים אימייל למשתמשים החדשים ומעדכנים אותם שהם קיבלו הרשאות למשאב. בלי קשר להגדרה או להגדרה של השדה הזה, המערכת מתעלמת משדה NotificationNewUser בכל בקשה בודדת. |
requests[] |
חובה. הבקשות שמציינות את המשתמשים המקושרים ליצירה. ניתן ליצור בכל קבוצה עד 1,000 קישורים למשתמשים. |
גוף התשובה
אם הפעולה בוצעה ללא שגיאות, גוף התגובה מכיל מופע של BatchCreateUserLinksResponse
.
היקפי הרשאות
נדרש היקף ההרשאות הבא של OAuth:
https://www.googleapis.com/auth/analytics.manage.users
CreateUserLinkRequest
הודעת בקשה ל-userLinks.create RPC.
למשתמשים יכולות להיות מספר כתובות אימייל שמשויכות לחשבון Google שלהם, ואחת מכתובות האימייל האלו היא כתובת האימייל ה'ראשית'. ניתן להשתמש בכל אחת מכתובות האימייל המשויכות לחשבון Google עבור UserLink חדש, אך ה-UserLink שהוחזר יכיל תמיד את כתובת האימייל ה "ראשית". כתוצאה מכך, כתובת האימייל שמשמשת כקלט ובפלט של הבקשה הזו עשויה להיות שונה.
ייצוג JSON |
---|
{
"parent": string,
"notifyNewUser": boolean,
"userLink": {
object ( |
שדות | |
---|---|
parent |
חובה. פורמט לדוגמה: accounts/1234 |
notifyNewUser |
זה שינוי אופציונלי. אם היא מוגדרת, יש לשלוח אימייל למשתמש החדש ולהודיע לו שהוא קיבל הרשאות למשאב. |
userLink |
חובה. קישור המשתמש ליצירה. |