Method: customers.uploadUserData

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

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

בקשת HTTP

POST https://googleads.googleapis.com/v14/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)

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