Method: customers.uploadUserData

מעלה את נתוני המשתמש הנתונים.

רשימת שגיאות שקרו: AuthenticationError AuthorizationError CollectionSizeError FieldError HeaderError InternalError MutateError OfflineUserDataJobError QuotaError RequestError UserDataError

בקשת HTTP

POST https://googleads.googleapis.com/v16/customers/{customerId}:uploadUserData

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

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

פרמטרים
customerId

string

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

גוף הבקשה

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

ייצוג JSON 
{
  "operations": [
    {
      object (UserDataOperation)
    }
  ],

  // Union field metadata can be only one of the following:
  "customerMatchUserListMetadata": {
    object (CustomerMatchUserListMetadata)
  }
  // End of list of possible types for union field metadata.
}
שדות
operations[]

object (UserDataOperation)

חובה. רשימת הפעולות שצריך לבצע.
שדה איחוד metadata. מטא-נתונים של הבקשה. metadata יכול להיות רק אחד מהבאים:
customerMatchUserListMetadata

object (CustomerMatchUserListMetadata)

מטא-נתונים של עדכוני נתונים ברשימת משתמשים מסוג 'התאמה ללקוחות'.

גוף התשובה

הודעת התגובה לגבי UserDataService.UploadUserData העלאות שבוצעו באמצעות השירות הזה לא תוצג בקטע 'חברים בפלח' ברשימת ההתאמה ללקוחות בממשק המשתמש של Google Ads.

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

ייצוג JSON 
{
  "uploadDateTime": string,
  "receivedOperationsCount": integer
}
שדות
uploadDateTime

string

התאריך שבו הבקשה התקבלה באמצעות API, בפורמט הבא: "yyyy-mm-dd hh:mm:ss+|-hh:mm". לדוגמה: "2019-01-01 12:32:45-08:00".
receivedOperationsCount

integer

מספר פעולות ההעלאה שהתקבלו על ידי ה-API.

היקפי הרשאות

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

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

למידע נוסף, עיינו בסקירה הכללית על OAuth 2.0.

UserDataOperation

פעולה לביצוע עבור UploadUserDataRequest.

ייצוג JSON 
{

  // Union field operation can be only one of the following:
  "create": {
    object (UserData)
  },
  "remove": {
    object (UserData)
  }
  // End of list of possible types for union field operation.
}
שדות
שדה איחוד operation. פעולה לביצוע עבור UploadUserDataRequest. operation יכול להיות רק אחד מהבאים:
create

object (UserData)

הרשימה של נתוני המשתמש שיש לצרף לרשימת המשתמשים.
remove

object (UserData)

רשימת נתוני המשתמש שיוסרו מרשימת המשתמשים.