REST Resource: exchanges.auctionPackages

משאב: AuctionPackage

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

ייצוג JSON 
{
  "name": string,
  "displayName": string,
  "status": enum (DiscoveryObjectStatus),
  "description": string,
  "format": enum (Format),
  "forecast": {
    object (SellerProvidedInventoryAvailabilityEstimate)
  },
  "externalDealId": string,
  "logoUrl": string,
  "floorPrice": {
    object (Money)
  },
  "startTime": string,
  "endTime": string,
  "mediumType": enum (MediumType),
  "urgOwners": [
    enum (UnderRepresentedGroup)
  ],
  "dv3MarketplaceUri": string
}
שדות
name

string

מזהה. שם המסלול היחסי של חבילת המכרז הזו. הערך צריך להיות בפורמט: exchanges/{seller_id}/auctionpackages/{auction_package_id} דוגמה: exchanges/1234/auctionPackage/5678. פלט בלבד.
displayName

string

חובה. השם המוצג של חבילת המכרז הזו. הערך חייב להיות מקודד בתבנית UTF-8, והגודל המקסימלי שלו הוא 240 תווים. חובה.
status

enum (DiscoveryObjectStatus)

חובה. הסטטוס של חבילת המכרז הזו. חבילות עם הסטטוס PAUSED או REMOVED לא מוצגות למפרסמים ב-DV360. חובה.
description

string

חובה. טקסט התיאור של החבילה. הקידוד חייב להיות UTF-8, והגודל המקסימלי הוא 2,000 תווים. חובה.
format

enum (Format)

חובה. אי אפשר לשנות. סוג פורמט המודעה הבסיסי. חובה. אחרי שיוצרים את המרחב, אי אפשר לעדכן את ההגדרה הזו.
forecast

object (SellerProvidedInventoryAvailabilityEstimate)

אופציונלי. פירוט התחזית של מלאי שטחי הפרסום בחבילת המכרז הזו. מפרסמים ב-DV360 יכולים לראות את הפירוטים האלה ולסנן אותם. אופציונלי.
externalDealId

string

חובה. אי אפשר לשנות. מזהה הדיל בבורסת הפרסום שמשמש בבקשות להצעות מחיר. עד 100 תווים. התווים המותרים הם אלפאנומריים, קו תחתון, מקף ונקודה. חובה. חובה. לא לאפשר עדכונים אחרי היצירה.
logoUrl

string

פלט בלבד. כתובת ה-URL של הלוגו של חבילת המכרז הזו.

פלט בלבד.
floorPrice

object (Money)

חובה. מחיר המינימום של חבילת המכרז הזו. חובה.
startTime

string (Timestamp format)

חובה. הזמן שבו המוצר הזה הופך לפעיל. התאריך חייב להיות מוקדם יותר מ-endTime. שעת ההתחלה לא יכולה להיות יותר משנה קדימה. חובה.

הפלט שנוצר תמיד יהיה בפורמט RFC 3339, עם נורמליזציה של Z ושימוש ב-0, 3, 6 או 9 ספרות אחרי הנקודה. אפשר להשתמש גם בהיסטים אחרים, לא רק ב-Z. דוגמאות: "2014-10-02T15:01:23Z", ‏ "2014-10-02T15:01:23.045123456Z" או "2014-10-02T15:01:23+05:30".
endTime

string (Timestamp format)

חובה. השעה שבה המוצר הזה מפסיק להיות פעיל. חובה.

הפלט שנוצר תמיד יהיה בפורמט RFC 3339, עם נורמליזציה של Z ושימוש ב-0, 3, 6 או 9 ספרות אחרי הנקודה. אפשר להשתמש גם בהיסטים אחרים, לא רק ב-Z. דוגמאות: "2014-10-02T15:01:23Z", ‏ "2014-10-02T15:01:23.045123456Z" או "2014-10-02T15:01:23+05:30".
mediumType

enum (MediumType)

חובה. סוג המדיום של חבילת המכרז.
urgOwners[]

enum (UnderRepresentedGroup)

אופציונלי. קבוצות עם ייצוג חסר שהבעלים חבר בהן, אם יש כאלה.
dv3MarketplaceUri

string

פלט בלבד. קישור ל-DV360 לחבילת מכירה פומבית ב-marketplace.

פורמט

פורמט המודעה בחבילת המכרז.

טיפוסים בני מנייה (enum)
DEAL_FORMAT_UNSPECIFIED לא צוין פורמט העסקה. לא תקף כקלט.
DEAL_FORMAT_DISPLAY פורמט התצוגה.
DEAL_FORMAT_VIDEO פורמט הווידאו.
DEAL_FORMAT_AUDIO פורמט אודיו.

Methods

create

 יצירת חבילת מכרז חדשה.

get

 מקבלים חבילה למכרז.

list

 החזרת רשימה של חבילות למכירות פומביות.

patch

 עדכון של חבילת מכרז.
העלאת לוגו לחבילה שצוינה.