Method: users.ingest

העלאת רשימת משתמשים ליעדים שצוינו. בניגוד ל-audienceMembers.ingest (שמוסיף משתמשים לרשימות קהלים ספציפיות של מפרסמים לצורך טירגוט), users.ingest קולט נתוני קישור של זהויות ברמת החשבון (לדוגמה, מזהי משתמשים שמקושרים למזהים לנייד) בלי קשר לפלחי קהל ספציפיים.

התכונה הזו זמינה רק לחשבונות שברשימת ההיתרים.

בקשת HTTP

POST https://datamanager.googleapis.com/v1/users:ingest

כתובת ה-URL כתובה בתחביר של gRPC Transcoding.

גוף הבקשה

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

ייצוג JSON 
{
  "destinations": [
    {
      object (Destination)
    }
  ],
  "users": [
    {
      object (User)
    }
  ],
  "encryptionInfo": {
    object (EncryptionInfo)
  },
  "validateOnly": boolean,
  "encoding": enum (Encoding)
}
שדות
destinations[]

object (Destination)

חובה. רשימת היעדים האפשריים להעברה.
users[]

object (User)

חובה. רשימת המשתמשים להעברה.
encryptionInfo

object (EncryptionInfo)

אופציונלי. מידע על ההצפנה של מפתחות ההצפנה שמשמשים להצפנת הנתונים.
validateOnly

boolean

אופציונלי. אם הערך הוא true, הבקשה מאומתת אבל לא מבוצעת.
encoding

enum (Encoding)

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

גוף התשובה

תשובה מ-IngestUsersRequest.

אם הפעולה בוצעה ללא שגיאות, גוף התגובה יכיל נתונים במבנה הבא:

ייצוג JSON 
{
  "requestId": string
}
שדות
requestId

string

מזהה הבקשה שנוצר לבקשת ההעלאה.

היקפי הרשאות

נדרש היקף ההרשאות הבא של OAuth:

  • https://www.googleapis.com/auth/datamanager

משתמש

מייצג משתמש יחיד, ומכיל מזהים כמו מידע אישי מזהה (PII) ומזהי מכשירים ניידים שמתייחסים לאותו משתמש.

ייצוג JSON 
{
  "userData": {
    object (UserData)
  },
  "mobileData": {
    object (MobileData)
  }
}
שדות
userData

object (UserData)

חובה. כמה פרטים שהמשתמשים סיפקו, שמשמשים כאמצעי לזיהוי המשתמש.
mobileData

object (MobileData)

חובה. כמה מחרוזות של מזהי מכשירים ניידים שמייצגות משתמש יחיד.