Method: advertisers.negativeKeywordLists.negativeKeywords.bulkEdit

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

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

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

בקשת HTTP

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

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

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

פרמטרים
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 Overview.