Method: sellers.creativeAssets.list

בתיבת הדו-שיח הזו מפורטים נכסי הקריאייטיב.

  • לדוגמה: GET /v1/sellers/321/creativeAssets
  • מחזירה רשימה של נכסי קריאייטיב ואסימון כדי לאחזר את הדף הבא אם הפעולה בוצעה בהצלחה.
  • הפונקציה מחזירה את קוד השגיאה INVALID_ARGUMENT אם המוכרים מספקים גודל דף לא תקין או אסימון דף לא תקין.

בקשת HTTP

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

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

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

פרמטרים
parent

string

חובה. אתר המכירה שהוא הבעלים של אוסף נכסי הקריאייטיב הזה. פורמט: sellers/{seller}

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

פרמטרים
pageSize

integer

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

string

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

string

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

גוף הבקשה

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

גוף התשובה

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

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

object (CreativeAsset)

הרשימה של נכסי הקריאייטיב.
nextPageToken

string

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

היקפי הרשאות

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

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

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