מעלה את נתוני המשתמש הנתונים.
רשימה של שגיאות התרעה: AuthenticationError AuthorizationError CollectionSizeError FieldError HeaderError InternalError MutateError OfflineUserDataJobError QuotaError RequestError UserDataError UserDataErrorUserDataError
בקשת HTTP
POST https://googleads.googleapis.com/v15/customers/{customerId}:uploadUserData
בכתובת ה-URL נעשה שימוש בתחביר המרת gRPC.
פרמטרים של נתיב
פרמטרים | |
---|---|
customerId |
חובה. מספר הלקוח שעבורו יש לעדכן את נתוני המשתמש. |
גוף הבקשה
גוף הבקשה מכיל נתונים במבנה הבא:
ייצוג JSON |
---|
{ "operations": [ { object ( |
שדות | |
---|---|
operations[] |
חובה. רשימת הפעולות שצריך לבצע. |
שדה איחוד metadata . מטא-נתונים של הבקשה. הערך של metadata יכול להיות רק אחת מהאפשרויות הבאות: |
|
customerMatchUserListMetadata |
מטא-נתונים של עדכוני נתונים ברשימת משתמשים של התאמה ללקוחות. |
גוף התגובה
הודעת התגובה לגבי UserDataService.UploadUserData
העלאות שבוצעו באמצעות שירות זה לא תוצג בקטע 'חברים בפלח' ברשימת ההתאמה ללקוחות בממשק המשתמש של Google Ads.
אם הפעולה בוצעה ללא שגיאות, גוף התגובה יכלול נתונים במבנה הבא:
ייצוג JSON |
---|
{ "uploadDateTime": string, "receivedOperationsCount": integer } |
שדות | |
---|---|
uploadDateTime |
התאריך שבו הבקשה התקבלה באמצעות API, בפורמט "yyyy-mm-dd hh:mm:ss+|-hh:mm". לדוגמה, "2019-01-01 12:32:45-08:00". |
receivedOperationsCount |
מספר פעולות ההעלאה שהתקבלו על ידי ה-API. |
היקפי הרשאות
נדרש היקף OAuth הבא:
https://www.googleapis.com/auth/adwords
למידע נוסף, עיין בסקירה הכללית על OAuth 2.0.
UserDataOperation
יש לבצע פעולה עבור UploadUserDataRequest.
ייצוג JSON |
---|
{ // Union field |
שדות | |
---|---|
שדה איחוד operation . יש לבצע פעולה עבור UploadUserDataRequest. הערך של operation יכול להיות רק אחת מהאפשרויות הבאות: |
|
create |
הרשימה של נתוני המשתמש שצריך לצרף לרשימת המשתמשים. |
remove |
הרשימה של נתוני המשתמש שיש להסיר מרשימת המשתמשים. |