Method: customers.keywordPlanCampaignKeywords.mutate

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

רשימת השגיאות שהמערכת זרקה: AuthenticationError AuthorizationError DatabaseError FieldError HeaderError InternalError KeywordPlanAdGroupKeywordError KeywordPlanCampaignKeywordError QuotaError RequestError ResourceCountLimitExceededError

בקשת HTTP

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

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

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

פרמטרים
customerId

string

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

גוף הבקשה

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

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

object (KeywordPlanCampaignKeywordOperation)

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

boolean

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

boolean

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

גוף התשובה

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

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

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

object (Status)

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

object (MutateKeywordPlanCampaignKeywordResult)

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

היקפי הרשאה

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

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

מידע נוסף זמין בOAuth 2.0 Overview.