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 metni

İstek içeriği 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),

      // 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
}
Alanlar
order.displayName

string

Alıcıya gösterilen sipariş adı. Maksimum 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. Maksimum 250 karakter. İsteğe bağlı.
order.publisherName

string

Yayıncı adı. Maksimum 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 DV3 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 Configuration: Exchange tarafındaki WSeat yapılandırmasını belirtir. Çok kullanıcılı anlaşmalardan yararlanan 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ı.

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

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.