Method: exchanges.orders.products.patch

یک محصول را به روز می کند.

درخواست HTTP

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

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

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

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

string

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

درخواست بدن

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

نمایندگی JSON
{
  "product": {
    "name": string,
    "displayName": string,
    "externalDealId": string,
    "transactionType": enum (TransactionType),
    "pricingType": enum (PricingType),
    "updateTime": string,
    "startTime": string,
    "endTime": string,
    "rateDetails": {
      "rateType": enum (RateType),
      "rate": {
        object (Money)
      },
      "unitsPurchasedCount": string
    },
    "creativeConfig": [
      {
        "creativeType": enum (CreativeType),
        "dimensionCreativeConfig": {
          object (DimensionCreativeConfig)
        },
        "durationCreativeConfig": {
          object (DurationCreativeConfig)
        }
      }
    ],
    "makegood": boolean,
    "makegoodDetails": {
      "originalExternalDealId": string,
      "reason": string
    },
    "creativeSource": enum (CreativeSource),
    "mediumType": enum (MediumType),
    "audienceTargetingConfig": {
      "audienceType": enum (AudienceType)
    },
    "targetingCriteria": {
      "selectedTargetingOptions": [
        {
          object (SelectedTargetingOption)
        }
      ]
    },
    "forecastResult": {
      "forecasts": [
        {
          object (Forecast)
        }
      ]
    },
    "errorDetails": {
      "message": string,
      "instantDealErrorStatus": enum (InstantDealErrorStatus)
    },
    "frequencyCap": {
      "timeUnit": enum (TimeUnit),
      "maxImpressions": string
    },
    "etag": string
  },
  "updateMask": string
}
فیلدها
product.displayName

string

نام نمایشی محصول

باید UTF-8 با حداکثر اندازه 240 بایت کدگذاری شود. مورد نیاز.

product.externalDealId

string

شناسه خارجی این شناسه معامله در سیستم صرافی است. حداکثر 100 کاراکتر کاراکترهای مجاز عبارتند از حروف عددی، زیرخط، خط تیره و نقطه. باید در همه محصولات منحصر به فرد باشد. مورد نیاز.

product.transactionType

enum ( TransactionType )

نوع معامله محصول مورد نیاز.

product.pricingType

enum ( PricingType )

نوع قیمت گذاری برای محصول مورد نیاز.

product.updateTime
(deprecated)

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

product.startTime

string ( Timestamp format)

زمانی که این محصول فعال می شود. باید زودتر از پایان زمان باشد. زمان شروع نمی تواند بیش از 1 سال در آینده باشد. مورد نیاز.

از 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" .

product.endTime

string ( Timestamp format)

زمانی که این محصول غیر فعال می شود. در حال حاضر نمی تواند بعد از سال 2036 باشد. الزامی است.

از 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" .

product.rateDetails

object ( RateDetails )

امتیاز دادن به جزئیات مورد نیاز.

product.creativeConfig[]

object ( CreativeConfig )

الزامات خلاقانه برای یک محصول برای محصول نوع معامله رزرو شده مورد نیاز است.

product.makegood
(deprecated)

boolean

نشان می دهد که آیا یک محصول یک محصول ساختگی است یا خیر.

product.makegoodDetails
(deprecated)

object ( MakegoodDetails )

جزئیات ساخت خوب برای یک محصول زمانی که محصول کالای اولیه است الزامی است.

product.creativeSource

enum ( CreativeSource )

منبع خلاقانه برای یک محصول اختیاری، پیش‌فرض CREATIVE_SOURCE_ADVERTISER است. پس از ایجاد محصول قابل تغییر نیست.

product.mediumType

enum ( MediumType )

نوع متوسط ​​برای یک محصول اگر برای سازگاری با عقب مشخص نشده باشد، پیش‌فرض به DIGITAL تبدیل می‌شود. پس از ایجاد محصول قابل تغییر نیست.

product.audienceTargetingConfig

object ( AudienceTargetingConfig )

اختیاری. پیکربندی هدفگیری مخاطب انتخاب شده در سطح معامله در Exchange اعمال شد.

product.targetingCriteria

object ( TargetingCriteria )

فقط خروجی مرجع معیارهای هدف گذاری محصول فقط برای سناریوهای معامله فوری قابل اجرا است.

product.forecastResult

object ( ForecastResult )

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

product.errorDetails

object ( ErrorDetails )

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

product.frequencyCap

object ( FrequencyCap )

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

product.etag

string

برچسبی که باید هنگام به روز رسانی محصول مشخص شود. فقط در صورتی که فیلد etag خالی نباشد باید برای به روز رسانی مشخص شود. فقط برای سناریوهای معامله فوری قابل اجرا است.

updateMask

string ( FieldMask format)

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

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

بدن پاسخگو

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

محدوده مجوز

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

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

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