Method: customers.campaignLabels.mutate

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

רשימת השגיאות שהופעלו: AuthenticationError AuthorizationError DatabaseError FieldError HeaderError InternalError LabelError MutateError NewResourceCreationError QuotaError RequestError

בקשת HTTP

POST https://googleads.googleapis.com/v16/customers/{customerId}/campaignLabels:mutate

כתובת ה-URL משתמשת בתחביר של Transcoding של gRPC.

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

פרמטרים
customerId

string

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

גוף הבקשה

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

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

object (CampaignLabelOperation)

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

boolean

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

boolean

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

גוף התשובה

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

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

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

object (Status)

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

object (MutateCampaignLabelResult)

כל התוצאות של ה-mutate.

היקפי הרשאה

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

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

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