Method: advertisers.negativeKeywordLists.negativeKeywords.list

בתיבת הדו-שיח הזו רשומים מילות המפתח השליליות ברשימה של מילות מפתח שליליות.

בקשת HTTP

GET https://displayvideo.googleapis.com/v2/advertisers/{advertiserId}/negativeKeywordLists/{negativeKeywordListId}/negativeKeywords

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

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

פרמטרים
advertiserId

string (int64 format)

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

string (int64 format)

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

פרמטרים של שאילתה

פרמטרים
pageSize

integer

גודל הדף המבוקש. חייב להיות בין 1 ל-1000. אם לא צוין ערך, ברירת המחדל תהיה 100. הפונקציה מחזירה את קוד השגיאה INVALID_ARGUMENT אם צוין ערך לא חוקי.
pageToken

string

אסימון שמזהה דף של תוצאות שהשרת צריך להחזיר.

בדרך כלל, זהו הערך של nextPageToken שהוחזר מהקריאה הקודמת ל-method negativeKeywords.list. אם לא מציינים שום אפשרות, יוחזר דף התוצאות הראשון.
orderBy

string

שדה שלפיו ממיינים את הרשימה. הערכים הקבילים הם:

  • keywordValue (ברירת מחדל)

סדר המיון שמוגדר כברירת מחדל הוא בסדר עולה. כדי לציין סדר יורד של שדה, צריך להוסיף לשם השדה את הסיומת ' description'. דוגמה: keywordValue desc
filter

string

מאפשר סינון לפי שדות של מילות מפתח שליליות.

תחביר נתמך:

  • ביטויי סינון למילות מפתח שליליות יכולים להכיל הגבלה אחת בלבד.
  • המונח של הגבלה הוא {field} {operator} {value}.
  • יש להשתמש באופרטור HAS (:) בכל השדות.

שדות נתמכים:

  • keywordValue

דוגמאות:

  • כל מילות המפתח השליליות שעבורן ערך מילת המפתח מכיל "google": keywordValue : "google"

האורך של השדה הזה לא יעלה על 500 תווים.

למידע נוסף, אפשר לעיין במדריך שלנו בנושא סינון בקשות LIST.

גוף הבקשה

גוף הבקשה חייב להיות ריק.

גוף התשובה

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

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

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

object (NegativeKeyword)

הרשימה של מילות המפתח השליליות.

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

string

אסימון לאחזור של דף התוצאות הבא.

צריך להעביר את הערך הזה בשדה pageToken בקריאה הבאה ל-method של negativeKeywords.list כדי לאחזר את דף התוצאות הבא.

היקפי הרשאות

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

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

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