Method: exchanges.orders.patch

עדכון הזמנה.

בקשת HTTP

PATCH https://dv360seller.googleapis.com/v1beta1/{order.name=exchanges/*/orders/*}

כתובת ה-URL משתמשת בתחביר של Transcoding של gRPC.

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

פרמטרים
order.name

string

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

גוף הבקשה

גוף הבקשה מכיל נתונים במבנה הבא:

ייצוג ב-JSON 
{
  "order": {
    "name": string,
    "displayName": string,
    "partnerId": [
      string
    ],
    "publisherEmail": string,
    "publisherName": string,
    "budget": {
      "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.
    },
    "status": enum (OrderStatus),
    "wseatConfig": {
      "exchangeWseatStatus": enum (WSeatStatus),
      "exchangeWseatIds": [
        string
      ],
      "updateTime": string
    },
    "updateTime": string
  },
  "updateMask": string
}
שדות
order.displayName

string

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

string (int64 format)

מזהי שותפים ב-Google Display & Video 360, שנקרא בעבר DoubleClick Bid Manager‏(DBM). חובה.
order.publisherEmail

string

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

string

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

object (Budget)

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

enum (OrderStatus)

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

object (WSeatConfig)

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

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

string (FieldMask format)

המסכה שקובע אילו שדות לעדכן. חובה.

זוהי רשימה של שמות שדות מוגדרים במלואם, שמופרדים בפסיקים. דוגמה: "user.displayName,photo"

גוף התשובה

אם הפעולה מצליחה, גוף התגובה מכיל מופע של Order.

היקפי הרשאה

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

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

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