Method: advertisers.negativeKeywordLists.negativeKeywords.list

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

בקשת HTTP

GET https://displayvideo.googleapis.com/v3/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 (ברירת מחדל)

ברירת המחדל של סדר המיון היא בסדר עולה. כדי לציין סדר יורד בשדה, צריך להוסיף את הסיומת ' סדר יורד" יש להוסיף לשם השדה. דוגמה: 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 בקריאה הבאה לשיטה negativeKeywords.list, כדי לאחזר את דף התוצאות הבא.

היקפי ההרשאות

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

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

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