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 משתמשת בתחביר של 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.