Method: customers.campaignSharedSets.mutate

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

רשימה של שגיאות שזוהו: AuthenticationError AuthorizationError CampaignSharedSetError ContextError DatabaseError DateError DistinctError FieldError HeaderError IdError InternalErrorMutateErrorNewResourceCreationErrorNotEmptyErrorNullErrorOperatorErrorQuotaErrorRangeErrorRequestErrorSizeLimitErrorStringFormatErrorStringLengthError

בקשת HTTP

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

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

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

פרמטרים
customerId

string

חובה. המזהה של הלקוח שהקבוצות המשותפות בקמפיין שלו עוברות שינוי.

גוף הבקשה

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

ייצוג JSON 
{
  "operations": [
    {
      object (CampaignSharedSetOperation)
    }
  ],
  "partialFailure": boolean,
  "validateOnly": boolean,
  "responseContentType": enum (ResponseContentType)
}
שדות
operations[]

object (CampaignSharedSetOperation)

חובה. רשימת הפעולות לביצוע בקבוצות משותפות של קמפיינים בודדים.
partialFailure

boolean

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

boolean

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

enum (ResponseContentType)

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

גוף התשובה

הודעת תשובה לגבי שינוי בקבוצה משותפת בקמפיין.

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

ייצוג JSON 
{
  "partialFailureError": {
    object (Status)
  },
  "results": [
    {
      object (MutateCampaignSharedSetResult)
    }
  ]
}
שדות
partialFailureError

object (Status)

שגיאות שנוגעות לכשלים בפעולות במצב 'כשל חלקי'. מוחזר רק כאשרpartFailure = true וכל השגיאות מתרחשות בתוך הפעולות. אם מתרחשות שגיאות מחוץ לפעולות (לדוגמה, שגיאות אימות), אנחנו מחזירים שגיאה ברמת ה-RPC.
results[]

object (MutateCampaignSharedSetResult)

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

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

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

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

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