REST Resource: exchanges.auctionPackages

משאב: AuctionPackage

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

ייצוג ב-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)

הסטטוס של חבילת המכרז הזו. חבילות בסטטוס 'מושהות' או 'הוסר' לא מוצגות למפרסמים ב-DV3. חובה.
description

string

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

enum (Format)

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

object (SellerProvidedInventoryAvailabilityEstimate)

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

string

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

string

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

פלט בלבד.
floorPrice

object (Money)

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

string (Timestamp format)

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

הפורמט הזה משתמש ב-RFC 3339, שבו הפלט שנוצר תמיד יהיה מנורמלי לפי Z וישמש בספרות עשרוניות של 0, 3, 6 או 9. אפשר להשתמש גם בשינויים (offsets) אחרים מלבד '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. אפשר להשתמש גם בשינויים (offsets) אחרים מלבד '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 של חבילת המכרז בזירת המסחר.

פורמט

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

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

Methods

create

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

get

 הפונקציה מקבלת חבילת מכרז.

list

 הצגת רשימת החבילות למכרזים.

patch

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