Method: orders.lines.reserve

שומר קו קיים.

  • הפונקציה מחזירה את השורה המעודכנת אם הפעולה בוצעה ללא שגיאות.
  • מחזירה את קוד השגיאה NOT_FOUND אם השורה לא קיימת.
  • הפונקציה מחזירה את קוד השגיאה INVALID_ARGUMENT אם לא הוגדר ערך lineTerms.
  • הפונקציה מחזירה את קוד השגיאה FAILED_PRECONDITION אם lineState אינו LINE_STATE_PENDING_RESERVATION.

בקשת HTTP

POST https://dv360outofhomeseller.googleapis.com/v1beta1/{name=orders/*/lines/*}:reserve

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

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

פרמטרים
name

string

השדה יכיל את שם השורה שיש לשמור. לדוגמה: "orders/123/lines/321"

גוף הבקשה

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

ייצוג JSON 
{
  "lineTerms": {
    object (LineTerms)
  },
  "reservationExpirationTime": string
}
שדות
lineTerms

object (LineTerms)

חובה. התנאים המובטחים על ידי המוכר בשורה הזו.
reservationExpirationTime

string (Timestamp format)

חובה. חותמת הזמן של תוקף ההזמנה. הקונה צריך לבצע הזמנה לפני שתוקף ההזמנה פג.

חותמת זמן ב-RFC3339 UTC 'Zulu' בפורמט של רזולוציה של ננו-שנייה ועד תשע ספרות עשרוניות. דוגמאות: "2014-10-02T15:01:23Z" ו-"2014-10-02T15:01:23.045123456Z".

גוף התשובה

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

היקפי הרשאות

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

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

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