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 kaynak adı. Sunucu tarafından oluşturulur. Örnek: "exchanges/1234/orders/5678/products/abc". Yalnızca çıkış.

İstek metni

İstek içeriği 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
    },
    "program": string,
    "buyerCustomParameters": {
      string: string,
      ...
    },
    "etag": string
  },
  "updateMask": string
}
Alanlar
product.displayName

string

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

UTF-8 olarak kodlanmış ve maksimum 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ünler genelinde 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ı.

Zaman damgasında RFC 3339 kullanılır. Yani oluşturulan çıkış her zaman Z ile normalleştirilir ve 0, 3, 6 veya 9 kesirli basamak kullanılır. "Z" dışındaki zaman farkları da 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'dan önce olmalıdır. Başlangıç zamanı, şu andan en fazla 1 yıl sonraya ait olabilir. Zorunlu.

Zaman damgasında RFC 3339 kullanılır. Yani oluşturulan çıkış her zaman Z ile normalleştirilir ve 0, 3, 6 veya 9 kesirli basamak kullanılır. "Z" dışındaki zaman farkları da 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. 2036 yılından sonra olamaz. Zorunlu.

Zaman damgasında RFC 3339 kullanılır. Yani oluşturulan çıkış her zaman Z ile normalleştirilir ve 0, 3, 6 veya 9 kesirli basamak kullanılır. "Z" dışındaki zaman farkları da 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 koşulları. Ayrılmış işlem türü ürün için zorunludur.
product.makegood
(deprecated)

boolean

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

object (MakegoodDetails)

Bir ürünün telafi ayrıntıları. Ürün iyileştirme olduğunda zorunludur.
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)

Ürünün ortam türü. Geriye dönük uyumluluk için belirtilmezse varsayılan olarak DIGITAL değerine ayarlanır. Ürün oluşturulduktan sonra değiştirilemez.
product.audienceTargetingConfig

object (AudienceTargetingConfig)

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

object (TargetingCriteria)

Yalnızca çıkış. Ürün hedefleme ölçütleri 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ş olmadığında ve tahmin sağlanmadığında 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. Bir hedefleme ölçütü nedeniyle tahmin sonucu 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.program

string

Yalnızca çıkış. Alıcının anında anlaşmayı oluşturduğu program. Exchange'in normal akışı için boş bırakın. Yalnızca anında anlaşma senaryoları için geçerlidir.
product.buyerCustomParameters

map (key: string, value: string)

Yalnızca çıkış. Anında anlaşma isteğinde alıcı tarafından ayarlanan özel anahtar/değer parametreleri. Yalnızca anında anlaşma senaryoları için geçerlidir.

"key": value çiftlerinin listesini içeren bir nesne. Örnek: { "name": "wrench", "mass": "1.3kg", "count": "3" }.
product.etag

string

Bir ürün güncellenirken belirtilmesi gereken bir etag. Yalnızca etag alanı boş değilse bir 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 metni

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ını inceleyin.