Method: exchanges.orders.patch

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

درخواست HTTP

PATCH https://dv360seller.googleapis.com/v1beta1/{order.name=exchanges/*/orders/*}

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

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

پارامترها
order.name

string

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

درخواست بدن

بدنه درخواست حاوی داده هایی با ساختار زیر است:

نمایندگی JSON 
{
  "order": {
    "name": string,
    "displayName": string,
    "partnerId": [
      string
    ],
    "publisherEmail": string,
    "publisherName": string,
    "budget": {
      "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.
    },
    "status": enum (OrderStatus),
    "wseatConfig": {
      "exchangeWseatStatus": enum (WSeatStatus),
      "exchangeWseatIds": [
        string
      ],
      "updateTime": string
    },
    "updateTime": string,
    "buyerInfo": {
      "partner": {
        object (PartnerInfo)
      },
      "advertisers": [
        {
          object (AdvertiserInfo)
        }
      ]
    }
  },
  "updateMask": string
}
فیلدها
order.displayName

string

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

order.partnerId[]

string ( int64 format)

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

order.publisherEmail

string

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

order.publisherName

string

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

order.budget

object ( Budget )

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

order.status

enum ( OrderStatus )

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

order.wseatConfig

object ( WSeatConfig )

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

order.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" .

order.buyerInfo

object ( BuyerInfo )

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

updateMask

string ( FieldMask format)

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

این فهرستی از نام‌های فیلدهای کاملاً واجد شرایط با کاما است. مثال: "user.displayName,photo" .

بدن پاسخگو

در صورت موفقیت آمیز بودن، بدنه پاسخ حاوی نمونه ای از Order است.

محدوده مجوز

به محدوده OAuth زیر نیاز دارد:

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

برای اطلاعات بیشتر، بهOAuth 2.0 Overview .