REST Resource: exchanges.orders

Kaynak: Sipariş

Alıcının kabul etmesi için pazarlığa açık olmayan bir teklif.

JSON gösterimi 
{
  "name": string,
  "displayName": string,
  "partnerId": [
    string
  ],
  "publisherEmail": string,
  "publisherName": string,
  "budget": {
    object (Budget)
  },
  "status": enum (OrderStatus),
  "wseatConfig": {
    object (WSeatConfig)
  },
  "updateTime": string,
  "buyerInfo": {
    object (BuyerInfo)
  }
}
Alanlar
name

string

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

string

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

string

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

string

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

object (Budget)

Yalnızca çıkış. Alıcı tarafından belirlenen bütçe. Yalnızca Anlık Fırsat senaryolarında geçerlidir.
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.
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.
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".
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.

Bütçe

Bütçe belirtildi.

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

enum (BudgetType)

Belirtilen bütçe türü.
Birleştirme alanı budget. Yalnızca bir bütçe türü dahil edilebilir. budget yalnızca aşağıdakilerden biri olabilir:
impressions

string (int64 format)

Gösterim bütçesi.
money

object (Money)

Para birimi bütçesi.

BudgetType

Bütçe türleri

Sıralamalar
BUDGET_TYPE_UNSPECIFIED Belirtilmemiş bütçe. Giriş için geçerli değil.
BUDGET_TYPE_CURRENCY Para birimi bütçesi.
BUDGET_TYPE_IMPRESSION Gösterim bütçesi.

OrderStatus

Siparişin durumu.

Sıralamalar
ORDER_STATUS_UNSPECIFIED Sipariş durumu belirtilmemiş. Beklenmeyen bir durumdur. Pazarlık durumunun bilinmediğini gösterir. Geçerli giriş değeri değil.
PENDING_ACCEPTANCE Sipariş durumu kabul bekleniyor.
ACCEPTED Sipariş durumu kabul edildi.
ARCHIVED Sipariş durumu arşivlendi.
CANCELLED Sipariş durumu iptal edildi.
NEGOTIATING Sipariş durumu görüşülüyor. Yalnızca Anlık Fırsat senaryoları için geçerlidir.

WSeatConfig

WSeat yapılandırması.

JSON gösterimi 
{
  "exchangeWseatStatus": enum (WSeatStatus),
  "exchangeWseatIds": [
    string
  ],
  "updateTime": string
}
Alanlar
exchangeWseatStatus

enum (WSeatStatus)

İsteğe bağlı. WSeat yapılandırması için Exchange tarafındaki mevcut durum.
exchangeWseatIds[]

string (int64 format)

İsteğe bağlı. Exchange tarafındaki WSeat kimlikleri.
updateTime

string (Timestamp format)

Yalnızca çıkış. Bu alan, WSeatConfiguration borsa tarafından güncellendiğinde DV3 tarafından otomatik olarak güncellenir.

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

WSeatStatus

WSeat Status enum seçenekleri.

Sıralamalar
W_SEAT_STATUS_UNSPECIFIED WSeatStatus belirtilmemiş.
W_SEAT_STATUS_ENFORCED WSeatStatus zorunlu kılındı. Exchange'in, WSeatId'yi DV3'e göndererek veya teklif yanıtlarındaki wseatid'leri doğrulayarak WSeatId'yi zorunlu kılıp kılmadığını gösterir.
W_SEAT_STATUS_NOT_ENFORCED WSeatStatus zorunlu kılınmıyor. Exchange'in teklif isteklerinde wseatid göndermediğini ve teklif isteklerindeki wseatid'yi doğrulamadığını gösterir.

BuyerInfo

Anında Anlaşma senaryoları için alıcı bilgileri.

JSON gösterimi 
{
  "partner": {
    object (PartnerInfo)
  },
  "advertisers": [
    {
      object (AdvertiserInfo)
    }
  ]
}
Alanlar
partner

object (PartnerInfo)

Yalnızca çıkış. İş ortağı bilgileri.
advertisers[]

object (AdvertiserInfo)

Yalnızca çıkış. Reklamveren bilgileri.

PartnerInfo

Anında Anlaşma senaryoları için iş ortağı bilgileri.

JSON gösterimi 
{
  "title": string
}
Alanlar
title

string

Yalnızca çıkış. Display & Video 360'taki iş ortağı görüntüleme başlığı.

AdvertiserInfo

Anında Anlaşma senaryoları için reklamveren bilgileri.

JSON gösterimi 
{
  "advertiserId": string,
  "domainUri": string
}
Alanlar
advertiserId

string (int64 format)

Yalnızca çıkış. Display & Video 360'taki reklamveren kimliği.
domainUri

string

Yalnızca çıkış. Reklamverenin web sitesinin alan adı URI'si.

Yöntemler

accept

 Siparişi kabul eder.

create

 Sipariş oluşturur.

get

 Sipariş alır.

list

 Listeleri sıralama

patch

 Siparişi günceller.