Method: exchanges.auctionPackages.list

הצגת רשימת החבילות למכרזים.

בקשת HTTP

GET https://dv360seller.googleapis.com/v1beta1/{parent=exchanges/*}/auctionPackages

כתובת ה-URL משתמשת בתחביר של Transcoding של gRPC.

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

פרמטרים
parent

string

שם המשאב ההורה. דוגמה: exchanges/123. חובה.

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

פרמטרים
pageSize

integer

מספר הפריטים המקסימלי להחזרה. הערך המקסימלי המותר הוא 50. אם לא צוין ערך או שהערך שצוין גדול מ-50, המערכת תשתמש ב-50 כגודל הדף.
pageToken

string

הערך של nextPageToken שהוחזר מבקשת List קודמת, אם יש כזו.
filter

string

מאפשר סינון לפי נכסים.

תחביר נתמך:

  • ביטויי מסננים מורכבים מהגבלה אחת או יותר.
  • אפשר לשלב הגבלות באמצעות אופרטורים לוגיים מסוג AND או OR. ברצף של הגבלות נעשה שימוש ב-AND באופן משתמע.
  • ההגבלה מוצגת בפורמט <field> <operator> <value>.
  • המפעיל חייב להיות EQUALS (=).
  • השדות הנתמכים כרגע:
    • externalDealId

דוגמאות:

  • אחזור חבילות למכרזים עם externalDealId שמוגדר כ-'package-1234' externalDealId="package-1234"

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

גוף הבקשה

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

גוף התשובה

תשובה לבקשה להציג רשימה של חבילות מכרזים.

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

ייצוג ב-JSON 
{
  "auctionPackage": [
    {
      object (AuctionPackage)
    }
  ],
  "nextPageToken": string
}
שדות
auctionPackage[]

object (AuctionPackage)

חבילות מכרזים שמוצגות. מספר הפריטים שיוחזר יהיה מוגבל על סמך השדה pageSize בבקשה.
nextPageToken

string

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

היקפי הרשאה

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

  • https://www.googleapis.com/auth/doubleclickbidmanager

מידע נוסף זמין בOAuth 2.0 Overview.