Method: customers.customAudiences.mutate

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

רשימת שגיאות שנדחתו: AuthenticationError AuthorizationError CustomAudienceError CustomInterestError FieldError FieldMaskError HeaderError InternalError MutateError OperationAccessDeniedError {20PolicyAccessDeniedErrorPolicyViolationErrorQuotaErrorRequestError

בקשת HTTP

POST https://googleads.googleapis.com/v17/customers/{customerId}/customAudiences:mutate

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

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

פרמטרים
customerId

string

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

גוף הבקשה

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

ייצוג JSON 
{
  "operations": [
    {
      object (CustomAudienceOperation)
    }
  ],
  "validateOnly": boolean
}
שדות
operations[]

object (CustomAudienceOperation)

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

boolean

אם הערך הוא True, הבקשה מאומתת אבל לא מבוצעת. מוצגות רק שגיאות, ולא תוצאות.

גוף התשובה

הודעת תשובה לגבי שינוי בקהל בהתאמה אישית.

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

ייצוג JSON 
{
  "results": [
    {
      object (MutateCustomAudienceResult)
    }
  ]
}
שדות
results[]

object (MutateCustomAudienceResult)

כל התוצאות של השינוי.

היקפי ההרשאות

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

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

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

CustomAudienceOperation

פעולה יחידה (יצירה, עדכון) של קהל בהתאמה אישית.

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

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

string (FieldMask format)

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

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

object (CustomAudience)

פעולת יצירה: לא צפוי שם משאב עבור הקהל המותאם אישית החדש.
update

object (CustomAudience)

פעולת עדכון: לקהל בהתאמה אישית אמור להיות שם משאב חוקי.
remove

string

פעולת הסרה: צפוי שם משאב לקהל בהתאמה אישית שהוסר, בפורמט הבא:

customers/{customerId}/customAudiences/{custom_audience_id}

MutateCustomAudienceResult

התוצאה של השינוי בקהל בהתאמה אישית.

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

string

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