Method: orders.lines.reserve

یک خط موجود را رزرو می کند.

  • در صورت موفقیت خط به روز شده را برمی گرداند.
  • اگر خط وجود نداشته باشد، کد خطا NOT_FOUND را برمی‌گرداند.
  • اگر lineTerms تنظیم نشده باشد، کد خطا را INVALID_ARGUMENT برمی‌گرداند.
  • اگر lineState LINE_STATE_PENDING_RESERVATION نباشد، کد خطا FAILED_PRECONDITION را برمی‌گرداند.

درخواست HTTP

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

URL از دستور GRPC Transcoding استفاده می کند.

پارامترهای مسیر

پارامترها
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 مراجعه کنید.