یک خط موجود را رزرو می کند.
- در صورت موفقیت خط به روز شده را برمی گرداند.
- اگر خط وجود نداشته باشد، کد خطا
NOT_FOUNDرا برمیگرداند. - اگر lineTerms تنظیم نشده باشد، کد خطا را
INVALID_ARGUMENTبرمیگرداند. - اگر lineState
LINE_STATE_PENDING_BOOKINGنباشد، کد خطاFAILED_PRECONDITIONرا برمیگرداند.
درخواست HTTP
POST https://dv360outofhomeseller.googleapis.com/v1beta1/{name=orders/*/lines/*}:book
URL از دستور GRPC Transcoding استفاده می کند.
پارامترهای مسیر
| پارامترها | |
|---|---|
name | فیلد حاوی نام خطی است که باید رزرو شود، به عنوان مثال: "orders/123/lines/321" |
درخواست بدن
بدنه درخواست حاوی داده هایی با ساختار زیر است:
| نمایندگی JSON |
|---|
{
"lineTerms": {
object ( |
| فیلدها | |
|---|---|
lineTerms | اختیاری. فروشنده شرایط این خط را تضمین کرده است. فقط در صورت تغییر شرایط پس از رزرو خط، باید ارائه شود. |
بدن پاسخگو
در صورت موفقیت آمیز بودن، بدنه پاسخ حاوی نمونه ای از Line است.
محدوده مجوز
به محدوده OAuth زیر نیاز دارد:
-
https://www.googleapis.com/auth/doubleclickbidmanager
برای اطلاعات بیشتر، به نمای کلی OAuth 2.0 مراجعه کنید.