Method: exchanges.publishers.list

הצגת רשימת בעלי תוכן דיגיטלי.

בקשת HTTP

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

כתובת ה-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 (=).
  • שדות נתמכים:
    • ExternalPublisherId
    • DisplayName
    • Status

דוגמאות:

  • אחזור של בעלי תוכן דיגיטלי שהסטטוס שלהם מוגדר כ'פעיל' status=DISCOVERY_OBJECT_STATUS_ACTIVE

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

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

גוף הבקשה

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

גוף התשובה

תגובה לבעלי תוכן דיגיטלי ברשימה.

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

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

object (Publisher)

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

string

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

היקפי הרשאה

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

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

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