עריכות בכמות גדולה של מילות מפתח שליליות ברשימה אחת של מילות מפתח שליליות.
הפעולה תמחק את מילות המפתח השליליות שצוינו ב-BulkEditNegativeKeywordsRequest.deleted_negative_keywords
ולאחר מכן תיצור את מילות המפתח השליליות שסופקו ב-BulkEditNegativeKeywordsRequest.created_negative_keywords
.
הפעולה הזו מובטחת באופן אטומי ולעולם לא תוביל להצלחה חלקית או לכשל חלקי.
בקשת HTTP
POST https://displayvideo.googleapis.com/v2/advertisers/{advertiserId}/negativeKeywordLists/{negativeKeywordListId}/negativeKeywords:bulkEdit
בכתובת ה-URL נעשה שימוש בתחביר המרת קידוד של gRPC.
פרמטרים של נתיב
פרמטרים | |
---|---|
advertiserId |
חובה. המזהה של המפרסם ב-DV360 שאליו שייכת רשימת מילות המפתח השליליות שברמה העליונה. |
negativeKeywordListId |
חובה. המזהה של רשימת מילות המפתח השליליות ההורה שאליה שייכות מילות המפתח השליליות. |
גוף הבקשה
גוף הבקשה מכיל נתונים במבנה הבא:
ייצוג JSON |
---|
{
"deletedNegativeKeywords": [
string
],
"createdNegativeKeywords": [
{
object ( |
שדות | |
---|---|
deletedNegativeKeywords[] |
מילות המפתח השליליות שיש למחוק באצווה, מצוינות כרשימה של |
createdNegativeKeywords[] |
מילות המפתח השליליות שיש ליצור בקבוצה, שצוינו כרשימה של |
גוף התשובה
הודעת תגובה עבור negativeKeywordService.BulkEditNegativeKeywords.
אם הפעולה בוצעה ללא שגיאות, גוף התשובה מכיל נתונים במבנה הבא:
ייצוג JSON |
---|
{
"negativeKeywords": [
{
object ( |
שדות | |
---|---|
negativeKeywords[] |
הרשימה של מילות המפתח השליליות שנוצרו בהצלחה. אם הרשימה ריקה, היא לא תופיע. |
היקפי הרשאות
נדרש היקף ההרשאות הבא של OAuth:
https://www.googleapis.com/auth/display-video
למידע נוסף, עיינו בסקירה הכללית על OAuth 2.0.