Method: customers.customerLifecycleGoal.configureCustomerLifecycleGoals

לעבד את ההגדרות הנתונות של מחזור החיים של הלקוח.

רשימת שגיאות הטמעה: AuthenticationError AuthorizationError CustomerLifecycleGoalConfigError HeaderError InternalError QuotaError RequestError

בקשת HTTP

POST https://googleads.googleapis.com/v15/customers/{customerId}/customerLifecycleGoal:configureCustomerLifecycleGoals

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

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

פרמטרים
customerId

string

חובה. מספר הלקוח שמבצע את ההעלאה.

גוף הבקשה

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

ייצוג JSON 
{
  "operation": {
    object (CustomerLifecycleGoalOperation)
  },
  "validateOnly": boolean
}
שדות
operation

object (CustomerLifecycleGoalOperation)

חובה. הפעולה לביצוע עדכון של יעד במחזור החיים של הלקוח.
validateOnly

boolean

אפשרות. אם הערך הוא true, הבקשה מאומתת אבל לא מבוצעת. רק שגיאות מוחזרות, לא תוצאות.

גוף התגובה

הודעת תשובה לגבי [CustomerLifecycleGoalService.configureCustomerLifecycleGoals][].

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

ייצוג JSON 
{
  "result": {
    object (ConfigureCustomerLifecycleGoalsResult)
  }
}
שדות
result

object (ConfigureCustomerLifecycleGoalsResult)

תוצאה של הגדרת היעד במחזור החיים של הלקוח.

היקפי הרשאות

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

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

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

CustomerLifecycleGoalOperation

פעולה יחידה ביעד במחזור החיים של הלקוח.

ייצוג JSON 
{
  "updateMask": string,

  // Union field operation can be only one of the following:
  "create": {
    object (CustomerLifecycleGoal)
  }
  // End of list of possible types for union field operation.
}
שדות
updateMask

string (FieldMask format)

אפשרות. FieldMask שקובע אילו שדות משאבים ישונו בעדכון.

זוהי רשימה של שמות שדות מלאים, שמופרדים בפסיקים. דוגמה: "user.displayName,photo"
שדה איחוד operation. פעולת השינוי. הערך של operation יכול להיות רק אחת מהאפשרויות הבאות:
create

object (CustomerLifecycleGoal)

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

ConfigureCustomerLifecycleGoalsResult

התוצאה של הגדרת היעד במחזור החיים של הלקוח.

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

string

הוחזרה עבור הפעולה המוצלחת.