Method: exchanges.orders.list

סדר הרשימות.

בקשת HTTP

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

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

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

פרמטרים
parent

string

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

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

פרמטרים
pageSize

integer

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

string

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

string

מאפשר סינון לפי מאפייני המוצר.

תחביר נתמך:

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

דוגמאות:

  • אחזור הזמנות שהסטטוס שלהן מוגדר כ'אושרה' status=ACCEPTED

  • אחזור הזמנות עם שם תצוגה של 'display name' displayName="display name"

  • אחזור הזמנות עם זמן עדכון גדול מ-'2024-02-12T18:47:29.784Z' updateTime>"2024-02-12T18:47:29.784Z"

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

גוף הבקשה

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

גוף התשובה

תגובה להזמנה ברשימה.

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

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

object (Order)

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

string

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

היקפי הרשאה

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

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

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