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ş adı. Maksimum 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. Maksimum 250 karakter. İsteğe bağlı.
publisherName

string

Yayıncı adı. Maksimum 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 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.
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".
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),

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

enum (BudgetType)

Belirtilen bütçe türü.
Yalnızca bir bütçe türü eklenebilir. Aşağıda, aynı anda kullanılamayan alanların listesi verilmiştir. Yanıt içinde en fazla bir alan ayarlanır:
impressions

string (int64 format)

Gösterim bütçesi.
money

object (Money)

Para birimi bütçesi.
Karşılıklı olarak hariç tutulan alanların sonu.

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ş. Beklenmedik. 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, borsa tarafından WSeatConfiguration güncellendiğinde DV360 tarafından otomatik olarak güncellenir.

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

WSeatStatus

WSeat Status numaralandırılmış değer seçenekleri.

Sıralamalar
W_SEAT_STATUS_UNSPECIFIED WSeatStatus belirtilmemiş.
W_SEAT_STATUS_ENFORCED WSeatStatus zorunlu kılındı. Bu, Exchange'in WSeatId'yi DV3'e göndererek veya teklif yanıtlarındaki WSeatId'leri doğrulayarak WSeatId'nin uygulanmasını sağladığı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şi alıyor.

list

 Listelerin sırası.

patch

 Siparişi günceller.