Method: exchanges.orders.patch

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

درخواست HTTP

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

این URL از سینتکس Transcoding در gRPC استفاده می‌کند.

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

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

string

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

درخواست بدنه

بدنه درخواست شامل داده‌هایی با ساختار زیر است:

نمایش JSON 
{
  "order": {
    "name": string,
    "displayName": string,
    "partnerId": [
      string
    ],
    "publisherEmail": string,
    "publisherName": string,
    "budget": {
      "budgetType": enum (BudgetType),

      // The following is a list of mutually exclusive fields. At most one of the
      // fields will be set in a response:
      "impressions": string,
      "money": {
        object (Money)
      }
      // End of mutually exclusive fields.
    },
    "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

نام سفارش نمایش داده شده به خریدار. حداکثر ۲۵۰ کاراکتر. اختیاری.

order.partnerId[]

string ( int64 format)

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

order.publisherEmail

string

ایمیل برای ناشر. باید فرمت ایمیل معتبری باشد. حداکثر ۲۵۰ کاراکتر. اختیاری.

order.publisherName

string

نام ناشر. حداکثر ۲۵۰ کاراکتر. الزامی.

order.budget

object ( Budget )

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

order.status

enum ( OrderStatus )

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

order.wseatConfig

object ( WSeatConfig )

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

order.updateTime

string ( Timestamp format)

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

از RFC 3339 استفاده می‌کند، که در آن خروجی تولید شده همیشه به صورت Z-normalized خواهد بود و از ارقام کسری ۰، ۳، ۶ یا ۹ استفاده می‌کند. آفست‌های غیر از "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 .

،

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

درخواست HTTP

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

این URL از سینتکس Transcoding در gRPC استفاده می‌کند.

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

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

string

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

درخواست بدنه

بدنه درخواست شامل داده‌هایی با ساختار زیر است:

نمایش JSON 
{
  "order": {
    "name": string,
    "displayName": string,
    "partnerId": [
      string
    ],
    "publisherEmail": string,
    "publisherName": string,
    "budget": {
      "budgetType": enum (BudgetType),

      // The following is a list of mutually exclusive fields. At most one of the
      // fields will be set in a response:
      "impressions": string,
      "money": {
        object (Money)
      }
      // End of mutually exclusive fields.
    },
    "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

نام سفارش نمایش داده شده به خریدار. حداکثر ۲۵۰ کاراکتر. اختیاری.

order.partnerId[]

string ( int64 format)

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

order.publisherEmail

string

ایمیل برای ناشر. باید فرمت ایمیل معتبری باشد. حداکثر ۲۵۰ کاراکتر. اختیاری.

order.publisherName

string

نام ناشر. حداکثر ۲۵۰ کاراکتر. الزامی.

order.budget

object ( Budget )

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

order.status

enum ( OrderStatus )

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

order.wseatConfig

object ( WSeatConfig )

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

order.updateTime

string ( Timestamp format)

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

از RFC 3339 استفاده می‌کند، که در آن خروجی تولید شده همیشه به صورت Z-normalized خواهد بود و از ارقام کسری ۰، ۳، ۶ یا ۹ استفاده می‌کند. آفست‌های غیر از "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 .

،

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

درخواست HTTP

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

این URL از سینتکس Transcoding در gRPC استفاده می‌کند.

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

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

string

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

درخواست بدنه

بدنه درخواست شامل داده‌هایی با ساختار زیر است:

نمایش JSON 
{
  "order": {
    "name": string,
    "displayName": string,
    "partnerId": [
      string
    ],
    "publisherEmail": string,
    "publisherName": string,
    "budget": {
      "budgetType": enum (BudgetType),

      // The following is a list of mutually exclusive fields. At most one of the
      // fields will be set in a response:
      "impressions": string,
      "money": {
        object (Money)
      }
      // End of mutually exclusive fields.
    },
    "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

نام سفارش نمایش داده شده به خریدار. حداکثر ۲۵۰ کاراکتر. اختیاری.

order.partnerId[]

string ( int64 format)

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

order.publisherEmail

string

ایمیل برای ناشر. باید فرمت ایمیل معتبری باشد. حداکثر ۲۵۰ کاراکتر. اختیاری.

order.publisherName

string

نام ناشر. حداکثر ۲۵۰ کاراکتر. الزامی.

order.budget

object ( Budget )

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

order.status

enum ( OrderStatus )

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

order.wseatConfig

object ( WSeatConfig )

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

order.updateTime

string ( Timestamp format)

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

از RFC 3339 استفاده می‌کند، که در آن خروجی تولید شده همیشه به صورت Z-normalized خواهد بود و از ارقام کسری ۰، ۳، ۶ یا ۹ استفاده می‌کند. آفست‌های غیر از "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 .

،

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

درخواست HTTP

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

این URL از سینتکس Transcoding در gRPC استفاده می‌کند.

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

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

string

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

درخواست بدنه

بدنه درخواست شامل داده‌هایی با ساختار زیر است:

نمایش JSON 
{
  "order": {
    "name": string,
    "displayName": string,
    "partnerId": [
      string
    ],
    "publisherEmail": string,
    "publisherName": string,
    "budget": {
      "budgetType": enum (BudgetType),

      // The following is a list of mutually exclusive fields. At most one of the
      // fields will be set in a response:
      "impressions": string,
      "money": {
        object (Money)
      }
      // End of mutually exclusive fields.
    },
    "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

نام سفارش نمایش داده شده به خریدار. حداکثر ۲۵۰ کاراکتر. اختیاری.

order.partnerId[]

string ( int64 format)

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

order.publisherEmail

string

ایمیل برای ناشر. باید فرمت ایمیل معتبری باشد. حداکثر ۲۵۰ کاراکتر. اختیاری.

order.publisherName

string

نام ناشر. حداکثر ۲۵۰ کاراکتر. الزامی.

order.budget

object ( Budget )

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

order.status

enum ( OrderStatus )

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

order.wseatConfig

object ( WSeatConfig )

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

order.updateTime

string ( Timestamp format)

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

از RFC 3339 استفاده می‌کند، که در آن خروجی تولید شده همیشه به صورت Z-normalized خواهد بود و از ارقام کسری ۰، ۳، ۶ یا ۹ استفاده می‌کند. آفست‌های غیر از "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 .