REST Resource: exchanges.orders

منبع: سفارش

یک پیشنهاد غیر قابل مذاکره برای خریدار برای پذیرش.

نمایندگی JSON 
{
  "name": string,
  "displayName": string,
  "partnerId": [
    string
  ],
  "publisherEmail": string,
  "publisherName": string,
  "budget": {
    object (Budget)
  },
  "status": enum (OrderStatus),
  "wseatConfig": {
    object (WSeatConfig)
  },
  "updateTime": string,
  "buyerInfo": {
    object (BuyerInfo)
  }
}
فیلدها
name

string

نام منبع نسبی برای سفارش تولید شده توسط سرور مثال: "exchanges/1234/orders/5678". فقط ما.

displayName

string

نام سفارش به خریدار نمایش داده می شود. حداکثر 250 کاراکتر اختیاری.

partnerId[]

string ( int64 format)

شناسه شریک در Google Display & Video 360 که قبلاً با عنوان Doubleclick Bid Manager (DBM) شناخته می‌شد. فقط یک شناسه شریک واحد را مجاز می کند. مورد نیاز.

publisherEmail

string

ایمیل برای ناشر باید قالب ایمیل معتبر باشد. حداکثر 250 کاراکتر اختیاری.

publisherName

string

نام ناشر حداکثر 250 کاراکتر مورد نیاز.

budget

object ( Budget )

فقط خروجی بودجه تعیین شده توسط خریدار فقط برای سناریوهای معامله فوری قابل اجرا است.

status

enum ( OrderStatus )

وضعیت سفارش پس از پذیرش، لغو یا بایگانی سفارش توسط کاربران DV3، وضعیت می تواند تغییر کند. همچنین پس از ایجاد در API از به‌روزرسانی به «لغو» پشتیبانی کنید تا نشان دهد این سفارش در Exchange لغو شده است.

wseatConfig

object ( WSeatConfig )

اختیاری. WSeat Configuration پیکربندی WSeat را در سمت مبادله مشخص می کند. انتظار می رود صرافی هایی که از معاملات چند صندلی استفاده می کنند، این حوزه را پرجمعیت و به روز نگه دارند.

updateTime

string ( Timestamp format)

فقط خروجی مهر زمانی که سفارش یا محصولات اساسی آن به‌روزرسانی شدند.

از RFC 3339 استفاده می کند، که در آن خروجی تولید شده همیشه با Z نرمال می شود و از 0، 3، 6 یا 9 رقم کسری استفاده می کند. افست های غیر از "Z" نیز پذیرفته می شود. مثال‌ها: "2014-10-02T15:01:23Z" ، "2014-10-02T15:01:23.045123456Z" یا "2014-10-02T15:01:23+05:30" .

buyerInfo

object ( BuyerInfo )

فقط خروجی اطلاعات خریدار، از جمله جزئیات شریک و آگهی‌دهنده. فقط برای سناریوهای معامله فوری قابل اجرا است.

بودجه

بودجه مشخص شده است.

نمایندگی JSON 
{
  "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.
}
فیلدها
budgetType

enum ( BudgetType )

نوع بودجه مشخص شده

budget میدانی اتحادیه فقط یک نوع بودجه می تواند لحاظ شود. budget فقط می تواند یکی از موارد زیر باشد:
impressions

string ( int64 format)

بودجه نمایشی

money

object ( Money )

بودجه ارزی

نوع بودجه

انواع بودجه

Enums
BUDGET_TYPE_UNSPECIFIED بودجه نامشخص برای ورودی معتبر نیست.
BUDGET_TYPE_CURRENCY بودجه ارزی
BUDGET_TYPE_IMPRESSION بودجه نمایشی

وضعیت سفارش

وضعیت برای سفارش

Enums
ORDER_STATUS_UNSPECIFIED وضعیت سفارش نامشخص است. غیر منتظره، نشان می دهد که وضعیت مذاکره ناشناخته است. مقدار ورودی معتبر نیست.
PENDING_ACCEPTANCE وضعیت سفارش در انتظار پذیرش
ACCEPTED وضعیت سفارش پذیرفته شد
ARCHIVED وضعیت سفارش بایگانی شد.
CANCELLED وضعیت سفارش لغو شد.
NEGOTIATING وضعیت سفارش در حال مذاکره فقط برای سناریوهای معامله فوری قابل اجرا است.

WSeatConfig

پیکربندی WSeat.

نمایندگی JSON 
{
  "exchangeWseatStatus": enum (WSeatStatus),
  "exchangeWseatIds": [
    string
  ],
  "updateTime": string
}
فیلدها
exchangeWseatStatus

enum ( WSeatStatus )

اختیاری. وضعیت فعلی در سمت Exchange برای پیکربندی WSeat.

exchangeWseatIds[]

string ( int64 format)

اختیاری. شناسه های WSeat در سمت Exchange.

updateTime

string ( Timestamp format)

فقط خروجی هنگامی که WSeatConfiguration توسط Exchange به روز می شود، این فیلد به طور خودکار توسط DV3 به روز می شود.

از RFC 3339 استفاده می کند، که در آن خروجی تولید شده همیشه با Z نرمال می شود و از 0، 3، 6 یا 9 رقم کسری استفاده می کند. افست های غیر از "Z" نیز پذیرفته می شود. مثال‌ها: "2014-10-02T15:01:23Z" ، "2014-10-02T15:01:23.045123456Z" یا "2014-10-02T15:01:23+05:30" .

وضعیت WSeat

گزینه های فهرست وضعیت WSeat.

Enums
W_SEAT_STATUS_UNSPECIFIED WSeatStatus نامشخص است.
W_SEAT_STATUS_ENFORCED WSeatStatus اجرا شد. نشان می‌دهد که Exchange WSeatId را با ارسال WSeatId به DV3 یا تأیید wseatids در پاسخ‌های پیشنهادی اجرا می‌کند.
W_SEAT_STATUS_NOT_ENFORCED WSeatStatus اجرا نشده است. نشان می دهد صرافی wseatid را در درخواست های پیشنهادی ارسال نمی کند و wseatid را در درخواست های پیشنهادی تأیید نمی کند.

اطلاعات خریدار

اطلاعات خریدار برای سناریوهای معامله فوری.

نمایندگی JSON 
{
  "partner": {
    object (PartnerInfo)
  },
  "advertisers": [
    {
      object (AdvertiserInfo)
    }
  ]
}
فیلدها
partner

object ( PartnerInfo )

فقط خروجی اطلاعات شریک

advertisers[]

object ( AdvertiserInfo )

فقط خروجی اطلاعات آگهی دهنده

PartnerInfo

اطلاعات شریک برای سناریوهای معامله فوری.

نمایندگی JSON 
{
  "title": string
}
فیلدها
title

string

فقط خروجی عنوان نمایش شریک در Display & Video 360.

AdvertiserInfo

اطلاعات آگهی‌دهنده برای سناریوهای معامله فوری.

نمایندگی JSON 
{
  "advertiserId": string,
  "domainUri": string
}
فیلدها
advertiserId

string ( int64 format)

فقط خروجی شناسه تبلیغ‌کننده در Display & Video 360.

domainUri

string

فقط خروجی URI دامنه وب سایت تبلیغ کننده.

روش ها

accept

 سفارش می پذیرد

create

 یک سفارش ایجاد می کند.

get

 سفارش می گیرد.

list

 ترتیب لیست ها

patch

 یک سفارش را به روز می کند.