חובה. המזהה של המפרסם ב-DV360 שאליו שייכות רשימות המיקומים שאוחזרו.
פרמטרים של שאילתה
פרמטרים
pageSize
integer
גודל הדף המבוקש. חייב להיות בין 1 ל-200. אם הפרמטר לא מוגדר, ערך ברירת המחדל הוא 100. הפונקציה מחזירה את קוד השגיאה INVALID_ARGUMENT אם צוין ערך לא חוקי.
pageToken
string
אסימון שמזהה דף של תוצאות שהשרת צריך להחזיר.
בדרך כלל, זהו הערך של nextPageToken שהוחזר מהקריאה הקודמת ל-method locationLists.list. אם לא מציינים שום אפשרות, יוחזר דף התוצאות הראשון.
orderBy
string
שדה שלפיו ממיינים את הרשימה. הערכים הקבילים הם:
locationListId (ברירת מחדל)
displayName
סדר המיון שמוגדר כברירת מחדל הוא בסדר עולה. כדי לציין סדר יורד של שדה, צריך להוסיף סיומת 'description' לשם השדה. דוגמה: displayName desc
filter
string
מאפשר סינון לפי שדות של רשימת מיקומים.
תחביר נתמך:
ביטויי סינון מורכבים מהגבלה אחת או יותר.
אפשר לשלב את ההגבלות באמצעות אופרטורים לוגיים AND או OR. רצף של הגבלות משתמש באופן לא מפורש ב-AND.
המונח של הגבלה הוא {field} {operator} {value}.
יש להשתמש באופרטור EQUALS (=) בכל השדות.
שדות נתמכים:
locationType
דוגמאות:
כל רשימת המיקומים האזוריים: locationType="TARGETING_LOCATION_TYPE_REGIONAL"
רשימה של כל מיקומי קירבה: locationType="TARGETING_LOCATION_TYPE_PROXIMITY"