Method: advertisers.negativeKeywordLists.negativeKeywords.bulkEdit

עריכת כמות גדולה של מילות מפתח שליליות ברשימה אחת של מילות מפתח שליליות.

הפעולה תמחק את מילות המפתח השליליות שצוינו ב-BulkEditNegativeKeywordsRequest.deleted_negative_keywords ולאחר מכן תיצור את מילות המפתח השליליות שצוינו ב-BulkEditNegativeKeywordsRequest.created_negative_keywords.

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

בקשת HTTP

POST https://displayvideo.googleapis.com/v3/advertisers/{advertiserId}/negativeKeywordLists/{negativeKeywordListId}/negativeKeywords:bulkEdit

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

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

פרמטרים
advertiserId

string (int64 format)

חובה. המזהה של המפרסם ב-DV360 שאליו שייכת רשימת מילות המפתח השליליות ברמת ההורה.
negativeKeywordListId

string (int64 format)

חובה. המזהה של רשימת מילות המפתח השליליות ברמת ההורה שאליה שייכות מילות המפתח השליליות.

גוף הבקשה

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

ייצוג JSON 
{
  "deletedNegativeKeywords": [
    string
  ],
  "createdNegativeKeywords": [
    {
      object (NegativeKeyword)
    }
  ]
}
שדות
deletedNegativeKeywords[]

string

מילות המפתח השליליות למחיקה בבת אחת, מצוינות כרשימה של keyword_values.
createdNegativeKeywords[]

object (NegativeKeyword)

מילות מפתח שליליות ליצירה בקבוצה, מצוינות כרשימה של NegativeKeywords.

גוף התשובה

הודעת תגובה עבור negativeKeywordService.BulkEditNegativeKeywords.

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

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

object (NegativeKeyword)

רשימת מילות המפתח השליליות שנוצרו בהצלחה.

אם הרשימה ריקה, הרשימה תיעלם.

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

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

  • https://www.googleapis.com/auth/display-video

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