REST Resource: exchanges.orders

משאב: הזמנה

הצעה לקונה שאי אפשר לנהל עליה משא ומתן.

ייצוג ב-JSON 
{
  "name": string,
  "displayName": string,
  "partnerId": [
    string
  ],
  "publisherEmail": string,
  "publisherName": string,
  "budget": {
    object (Budget)
  },
  "status": enum (OrderStatus),
  "wseatConfig": {
    object (WSeatConfig)
  },
  "updateTime": string,
  "buyerInfo": {
    object (BuyerInfo)
  }
}
שדות
name

string

שם המשאב היחסי של ההזמנה. נוצר על ידי השרת. לדוגמה: "exchanges/1234/orders/5678". פלט בלבד.
displayName

string

שם ההזמנה שמוצג לקונה. עד 250 תווים. אופציונלי.
partnerId[]

string (int64 format)

מזהה השותף ב-Google Display & Video 360, שנקרא בעבר Doubleclick Bid Manager‏(DBM). אפשר להזין רק מזהה שותף אחד. חובה.
publisherEmail

string

כתובת אימייל של בעל התוכן הדיגיטלי. חייב להיות בפורמט תקין של כתובת אימייל. עד 250 תווים. אופציונלי.
publisherName

string

שם המוציא לאור. עד 250 תווים. חובה.
budget

object (Budget)

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

enum (OrderStatus)

סטטוס ההזמנה. הסטטוס יכול להשתנות אחרי שמשתמשי DV3 יאשרו, יבטלו או יעבירו לארכיון הזמנה. בנוסף, הוספנו תמיכה בעדכון סטטוס ההזמנה ל 'בוטלה' אחרי שהיא נוצרה ב-API, כדי לציין שההזמנה הזו בוטלה ב-Exchange.
wseatConfig

object (WSeatConfig)

אופציונלי. ‫WSeat Configuration Specifies the WSeat configuration on the exchange side. בורסות שמשתמשות בעסקאות עם כמה מושבים צפויות להמשיך לאכלס את השדה הזה ולעדכן אותו.
updateTime

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".
buyerInfo

object (BuyerInfo)

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

תקציב

הוגדר תקציב.

ייצוג ב-JSON 
{
  "budgetType": enum (BudgetType),

  // Union field budget can be only one of the following:
  "impressions": string,
  "money": {
    object (Money)
  }
  // End of list of possible types for union field budget.
}
שדות
budgetType

enum (BudgetType)

סוג התקציב שצוין.
שדה איחוד budget. אפשר לכלול רק סוג אחד של תקציב. הערך budget יכול להיות רק אחד מהבאים:
impressions

string (int64 format)

תקציב חשיפות.
money

object (Money)

תקציב במטבע.

BudgetType

סוגי תקציבים

טיפוסים בני מנייה (enum)
BUDGET_TYPE_UNSPECIFIED תקציב לא מוגדר. לא תקף כקלט.
BUDGET_TYPE_CURRENCY תקציב במטבע.
BUDGET_TYPE_IMPRESSION תקציב חשיפות.

OrderStatus

הסטטוס של ההזמנה.

טיפוסים בני מנייה (enum)
ORDER_STATUS_UNSPECIFIED לא צוין סטטוס ההזמנה. לא צפוי, מציין שהסטטוס של המשא ומתן לא ידוע. ערך קלט לא תקין.
PENDING_ACCEPTANCE סטטוס ההזמנה בהמתנה לאישור.
ACCEPTED סטטוס ההזמנה: אושרה.
ARCHIVED סטטוס ההזמנה הוא 'הועברה לארכיון'.
CANCELLED סטטוס ההזמנה הוא 'בוטלה'.
NEGOTIATING סטטוס ההזמנה הוא 'במשא ומתן'. רלוונטי רק לתרחישים של עסקאות מיידיות.

WSeatConfig

הגדרת WSeat.

ייצוג ב-JSON 
{
  "exchangeWseatStatus": enum (WSeatStatus),
  "exchangeWseatIds": [
    string
  ],
  "updateTime": string
}
שדות
exchangeWseatStatus

enum (WSeatStatus)

אופציונלי. הסטטוס הנוכחי בצד של Exchange לגבי הגדרת WSeat.
exchangeWseatIds[]

string (int64 format)

אופציונלי. מזהי WSeat בצד ה-Exchange.
updateTime

string (Timestamp format)

פלט בלבד. השדה הזה מתעדכן אוטומטית על ידי DV3 כשהעדכון של WSeatConfiguration מתבצע על ידי הבורסה.

הפונקציה משתמשת ב-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".

WSeatStatus

אפשרויות של טיפוסים בני מנייה (enum) לסטטוס של WSeat.

טיפוסים בני מנייה (enum)
W_SEAT_STATUS_UNSPECIFIED לא צוין WSeatStatus.
W_SEAT_STATUS_ENFORCED האכיפה של WSeatStatus. מציין ש-Exchange אוכף את WSeatId על ידי שליחת WSeatId ל-DV3 או על ידי אימות של wseatids בתגובות להצעות מחיר.
W_SEAT_STATUS_NOT_ENFORCED ההגדרה WSeatStatus לא נאכפת. מציין ש-Exchange לא שולח wseatid בבקשות להצעות מחיר ולא מאמת wseatid בבקשות להצעות מחיר.

BuyerInfo

פרטי הקונה בתרחישים של מבצעים מיידיים.

ייצוג ב-JSON 
{
  "partner": {
    object (PartnerInfo)
  },
  "advertisers": [
    {
      object (AdvertiserInfo)
    }
  ]
}
שדות
partner

object (PartnerInfo)

פלט בלבד. פרטי השותף.
advertisers[]

object (AdvertiserInfo)

פלט בלבד. מידע על המפרסם.

PartnerInfo

מידע על השותף בתרחישים של עסקאות מיידיות.

ייצוג ב-JSON 
{
  "title": string
}
שדות
title

string

פלט בלבד. השם המוצג של השותף ב-Display & Video 360.

AdvertiserInfo

פרטי המפרסם בתרחישים של מבצעים מיידיים.

ייצוג ב-JSON 
{
  "advertiserId": string,
  "domainUri": string
}
שדות
advertiserId

string (int64 format)

פלט בלבד. מזהה המפרסם ב-Display & Video 360.
domainUri

string

פלט בלבד. ה-URI של הדומיין של אתר המפרסם.

Methods

accept

 המוכר מקבל את ההזמנה.

create

 יצירת הזמנה.

get

 מקבל הזמנה.

list

 סדר הרשימות.

patch

 עדכון של הזמנה.