Method: exchanges.orders.list

רשימת ההזמנות.

בקשת HTTP

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

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

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

פרמטרים
parent

string

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

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

פרמטרים
pageSize

integer

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

string

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

string

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

תחביר נתמך:

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

דוגמאות:

  • קבלת הזמנות עם סטטוס שמוגדר כ-ACCEPTED 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.