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

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

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

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