Method: exchanges.orders.patch

Siparişi günceller.

HTTP isteği

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

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

Yol parametreleri

Parametreler
order.name

string

Siparişin göreli kaynak adı. Sunucu tarafından oluşturulur. Örnek: "exchanges/1234/orders/5678". Yalnızca Çıkış.

İstek içeriği

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

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

string

Alıcıya gösterilen siparişin adı. Maks. 250 karakter. İsteğe bağlı.
order.partnerId[]

string (int64 format)

Google Display & Video 360'taki iş ortağı kimliği (eski adıyla DoubleClick Bid Manager (DBM)). Yalnızca tek bir iş ortağı kimliğine izin verir. Zorunlu.
order.publisherEmail

string

Yayıncının e-posta adresi. Geçerli bir e-posta biçimi girin. Maks. 250 karakter. İsteğe bağlı.
order.publisherName

string

Yayıncı adı. Maks. 250 karakter. Zorunlu.
order.budget

object (Budget)

Yalnızca çıkış. Alıcı tarafından belirlenen bütçe. Yalnızca Anlık Fırsat senaryolarında geçerlidir.
order.status

enum (OrderStatus)

Sipariş durumu. DV360 kullanıcıları bir siparişi kabul ettikten, iptal ettikten veya arşivledikten sonra durum değişebilir. Ayrıca, bu siparişin Exchange'de iptal edildiğini belirtmek için API'de oluşturulduktan sonra "İPTAL EDİLDİ" olarak güncellenmesini de destekler.
order.wseatConfig

object (WSeatConfig)

İsteğe bağlı. WSeat Yapılandırması, borsa tarafındaki WSeat yapılandırmasını belirtir. Çok koltuklu anlaşmaları kullanan borsaların bu alanı doldurulmuş ve güncel tutması beklenir.
order.updateTime

string (Timestamp format)

Yalnızca çıkış. Siparişin veya temel alınan ürünlerin güncellendiği zaman damgası.

Oluşturulan çıkışın her zaman Z ile normalleştirildiği ve 0, 3, 6 veya 9 kesirli basamak kullandığı RFC 3339'u kullanır. "Z" dışındaki saat farkları da kabul edilir. Örnekler: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" veya "2014-10-02T15:01:23+05:30".
order.buyerInfo

object (BuyerInfo)

Yalnızca çıkış. İş ortağı ve reklamveren ayrıntıları dahil olmak üzere alıcı bilgileri. Yalnızca Anlık Fırsat senaryolarında geçerlidir.
updateMask

string (FieldMask format)

Hangi alanların güncelleneceğini kontrol etmek için kullanılan maske. Zorunlu.

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

Yanıt gövdesi

Başarılıysa yanıt metni, Order öğ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.