Method: advertisers.negativeKeywordLists.negativeKeywords.bulkEdit

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

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

הפעולה הזו תמיד תהיה אטומית, ואף פעם לא תגרום להצלחה חלקית או לכשל חלקי.

בקשת HTTP

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

כתובת ה-URL משתמשת בתחביר של Transcoding של 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.