Method: orders.lines.reserve

حجز سطر حالي.

  • عرض السطر المعدَّل في حال نجاحه.
  • تعرض رمز الخطأ NOT_FOUND إذا لم يكن الخط موجودًا.
  • تعرض رمز الخطأ INVALID_ARGUMENT إذا لم يتم ضبط lineDuration.
  • تعرض رمز الخطأ 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) "زولو" بدقة نانوثانية وما يصل إلى تسعة أرقام كسرية. أمثلة: "2014-10-02T15:01:23Z" و"2014-10-02T15:01:23.045123456Z".

نص الاستجابة

إذا كانت الاستجابة ناجحة، يحتوي نص الاستجابة على مثال Line.

نطاقات التفويض

يجب توفير نطاق OAuth التالي:

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

لمزيد من المعلومات، يُرجى الاطِّلاع على نظرة عامة على OAuth 2.0.