Method: sellers.availabilityOrders.availabilityLines.list

בתיבת הדו-שיח הזו מפורטים שורות של הזמנת זמינות.

  • לדוגמה: GET /v1/sellers/111/availabilityOrders/123/availabilityLines
  • הפונקציה מחזירה רשימה של שורות זמינות ואסימון כדי לאחזר את הדף הבא, אם הפעולה בוצעה ללא שגיאות.
  • הפונקציה מחזירה את קוד השגיאה PERMISSION_DENIED אם למשתמש אין גישה לאתר המכירה או שמזהה המפיץ לא קיים.
  • הפונקציה מחזירה את קוד השגיאה INVALID_ARGUMENT אם המוכרים מספקים גודל דף לא תקין או אסימון דף לא תקין.
  • הפונקציה מחזירה את קוד השגיאה NOT_FOUND אם הזמנת הזמינות לא קיימת.

בקשת HTTP

GET https://dv360outofhomeseller.googleapis.com/v1/{parent=sellers/*/availabilityOrders/*}/availabilityLines

בכתובת ה-URL נעשה שימוש בתחביר המרת קידוד של gRPC.

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

פרמטרים
parent

string

חובה. השם של משאב ההורה. פורמט: sellers/{seller}/availabilityOrders/{availability_order}

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

פרמטרים
pageSize

integer

המספר המקסימלי של פריטים שצריך להחזיר. ייתכן שהשירות יחזיר פחות מהערך הזה. מספר קווי הזמינות המקסימלי הוא 1,000. אם לא צויין ערך, יוחזרו לכל היותר 1,000 שורות זמינות.
pageToken

string

הערך NextPageToken שהוחזר מבקשת רשימה קודמת, אם קיימת.
filter

string

מסנן הרשימה. כרגע יש תמיכה בסינון לפי מצב, עם התחביר: "state = [STATE]". אפשר להשתמש באופרטורים הלוגיים AND ו-OR כדי ליצור מסנני שרשרת.
orderBy

string

הסדר לפי מחרוזת שמשמש לציון סדר המיון של התוצאות. כרגע יש תמיכה בהזמנה עד updateTime, צריך לציין 'updateTime' כדי לקבל תוצאות ממוינות לפי updateTime בסדר עולה או לפי updateTime desc לסדר יורד.

גוף הבקשה

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

גוף התשובה

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

ייצוג JSON 
{
  "availabilityLines": [
    {
      object (AvailabilityLine)
    }
  ],
  "nextPageToken": string
}
שדות
availabilityLines[]

object (AvailabilityLine)

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

string

אסימון לאחזור של דף התוצאות הבא. צריך להעביר את הערך הזה בשדה pageToken בקריאה הבאה לשיטה availabilityLines.list, כדי לאחזר את דף התוצאות הבא.

היקפי הרשאות

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

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

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