יוצרים מידע על קישורים של כמה משתמשים לחשבון או לנכס.
השיטה הזו מאפשרת עסקאות. אם לא ניתן ליצור 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 |
אפשרות. אם הוא מוגדר, יש לשלוח אימייל למשתמשים החדשים ולהודיע להם שקיבלו הרשאות למשאב. בלי קשר להגדרה או להגדרה של השדה הזה, המערכת תתעלם מהשדה המיידע את המשתמש החדש בכל בקשה בנפרד. |
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 |
חובה. קישור המשתמש ליצירה. |