Method: exchanges.orders.products.patch

Bir ürünü günceller.

HTTP isteği

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

URL, gRPC Kod Dönüştürme söz dizimini kullanır.

Yol parametreleri

Parametreler
product.name

string

Ürünün göreli rota adı. Sunucu tarafından oluşturulur. Örnek: "exchanges/1234/orders/5678/products/abc". Yalnızca çıkış.

İstek içeriği

İstek metni aşağıdaki yapıyla birlikte verileri içerir:

JSON gösterimi 
{
  "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
}
Alanlar
product.displayName

string

Ürünün görünen adı.

UTF-8 kodlu olmalı ve en fazla 240 bayt boyutunda olmalıdır. Zorunlu.
product.externalDealId

string

Harici kimlik. Bu, exchange sistemindeki anlaşma kimliğidir. En fazla 100 karakter. İzin verilen karakterler alfanümerik, alt çizgi, kısa çizgi ve noktadır. Tüm ürünlerde benzersiz olmalıdır. Zorunlu.
product.transactionType

enum (TransactionType)

Ürün işlem türü. Zorunlu.
product.pricingType

enum (PricingType)

Ürünün fiyatlandırma türü. Zorunlu.
product.updateTime
(deprecated)

string (Timestamp format)

Ürünün en son güncellendiği zaman damgası.

Oluşturulan çıktının her zaman Z normalleştirileceği ve 0, 3, 6 veya 9 kesirli basamak kullanacağı RFC 3339'u kullanır. "Z" dışındaki ofsetler de kabul edilir. Örnekler: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" veya "2014-10-02T15:01:23+05:30".
product.startTime

string (Timestamp format)

Bu ürünün etkinleştiği zaman. endTime değerinden önce olmalıdır. Başlangıç zamanı en fazla 1 yıl sonrası olabilir. Zorunlu.

Oluşturulan çıktının her zaman Z normalleştirileceği ve 0, 3, 6 veya 9 kesirli basamak kullanacağı RFC 3339'u kullanır. "Z" dışındaki ofsetler de kabul edilir. Örnekler: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" veya "2014-10-02T15:01:23+05:30".
product.endTime

string (Timestamp format)

Bu ürünün etkin olmadığı zaman. Şu anda 2036 yılından sonra olamaz. Zorunlu.

Oluşturulan çıktının her zaman Z normalleştirileceği ve 0, 3, 6 veya 9 kesirli basamak kullanacağı RFC 3339'u kullanır. "Z" dışındaki ofsetler de kabul edilir. Örnekler: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" veya "2014-10-02T15:01:23+05:30".
product.rateDetails

object (RateDetails)

Fiyat ayrıntıları. Zorunlu.
product.creativeConfig[]

object (CreativeConfig)

Bir ürün için reklam öğesi gereksinimleri. Rezerve işlem türü ürün için gereklidir.
product.makegood
(deprecated)

boolean

Bir ürünün telafi ürünü olup olmadığını belirtir.
product.makegoodDetails
(deprecated)

object (MakegoodDetails)

Bir ürünle ilgili telafi bilgileri. Ürün telafi amaçlıysa gereklidir.
product.creativeSource

enum (CreativeSource)

Bir ürünün reklam öğesi kaynağı. İsteğe bağlıdır, varsayılan olarak CREATIVE_SOURCE_ADVERTISER değerine ayarlanır. Ürün oluşturulduktan sonra değiştirilemez.
product.mediumType

enum (MediumType)

Bir ürünün medya türü. Geriye dönük uyumluluk için belirtilmezse varsayılan olarak DİJİTAL olur. Ürün oluşturulduktan sonra değiştirilemez.
product.audienceTargetingConfig

object (AudienceTargetingConfig)

İsteğe bağlı. Exchange'te anlaşma düzeyinde uygulanan kitle hedefleme yapılandırması seçildi.
product.targetingCriteria

object (TargetingCriteria)

Yalnızca çıkış. Ürün hedefleme ölçütleriyle ilgili referanslar. Yalnızca anında anlaşma senaryoları için geçerlidir.
product.forecastResult

object (ForecastResult)

Ürün tahmini sonuçları. Hedefleme ölçütleri boş değilse ve tahmin sağlanmamışsa gereklidir. Yalnızca anında anlaşma senaryoları için geçerlidir.
product.errorDetails

object (ErrorDetails)

Belirli ürün alanları güncellenemediğinde hata ayrıntıları belirtilmelidir. Tahmin sonucu bir hedefleme ölçütü nedeniyle sağlanamadığında veya üründe güncelleme yapılamadığında gereklidir. Yalnızca anında anlaşma senaryoları için geçerlidir.
product.frequencyCap

object (FrequencyCap)

Yalnızca çıkış. Alıcı tarafından seçilen sıklık sınırı. Yalnızca anında anlaşma senaryoları için geçerlidir.
product.etag

string

Ürün güncellenirken belirtilmesi gereken bir etag. Yalnızca etag alanı boş değilse güncelleme için belirtilmesi gerekir. Yalnızca anında anlaşma senaryoları için geçerlidir.
updateMask

string (FieldMask format)

Hangi alanların güncelleneceğini kontrol eden maske. Zorunlu.

Bu, alanların tam nitelikli adlarının virgülle ayrılmış bir listesidir. Örnek: "user.displayName,photo".

Yanıt gövdesi

Başarılıysa yanıt metni, Product öğesinin bir örneğini içerir.

Yetkilendirme kapsamları

Aşağıdaki OAuth kapsamını gerektirir:

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

Daha fazla bilgi için OAuth 2.0 Overview sayfasına bakın.