Method: accounts.userLinks.batchCreate

יצירת מידע על קישורים של כמה משתמשים לחשבון או לנכס.

השיטה הזו מיועדת לטרנזקציות. אם לא ניתן ליצור UserLink כלשהו, לא ייווצר אף UserLink.

בקשת HTTP

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

בכתובת ה-URL נעשה שימוש בתחביר המרת קידוד של gRPC.

פרמטרים של נתיב

פרמטרים
parent

string

חובה. החשבון או הנכס שעבורם נכללים כל קישורי המשתמשים בבקשה. חובה לבחור אפשרות לשדה הזה. שדה ההורה בהודעות CreateUserLinkRequest חייב להיות ריק או להתאים לשדה זה. פורמט לדוגמה: accounts/1234

גוף הבקשה

גוף הבקשה מכיל נתונים במבנה הבא:

ייצוג JSON 
{
  "notifyNewUsers": boolean,
  "requests": [
    {
      object (CreateUserLinkRequest)
    }
  ]
}
שדות
notifyNewUsers

boolean

זה שינוי אופציונלי. אם היא מוגדרת, שולחים אימייל למשתמשים החדשים ומעדכנים אותם שהם קיבלו הרשאות למשאב. בלי קשר להגדרה או להגדרה של השדה הזה, המערכת מתעלמת משדה NotificationNewUser בכל בקשה בודדת.
requests[]

object (CreateUserLinkRequest)

חובה. הבקשות שמציינות את המשתמשים המקושרים ליצירה. ניתן ליצור בכל קבוצה עד 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 (UserLink)
  }
}
שדות
parent

string

חובה. פורמט לדוגמה: accounts/1234
notifyNewUser

boolean

זה שינוי אופציונלי. אם היא מוגדרת, יש לשלוח אימייל למשתמש החדש ולהודיע לו שהוא קיבל הרשאות למשאב.