Kaynak: GuaranteedOrder
Garantili sipariş.
Garantili siparişler, garantili envanter kaynaklarının üst öğesidir. Garantili envanter kaynağı oluştururken envanter kaynağına garantili sipariş kimliği atanmalıdır.
JSON gösterimi |
---|
{ "name": string, "legacyGuaranteedOrderId": string, "exchange": enum ( |
Alanlar | |
---|---|
name |
Yalnızca çıkış. Garantili siparişin kaynak adı. |
legacyGuaranteedOrderId |
Yalnızca çıkış. Garantili siparişin eski kimliği. Orijinal exchange tarafından atanır. Eski kimlik bir exchange'te benzersizdir ancak tüm garantili siparişlerde benzersiz olması garanti edilmez. Bu kimlik, SDF ve kullanıcı arayüzünde kullanılır. |
exchange |
Zorunlu. Değişmez. Garantili siparişin oluşturulduğu exchange. |
guaranteedOrderId |
Yalnızca çıkış. Garantili siparişin benzersiz tanımlayıcısıdır. Garantili sipariş kimlikleri |
displayName |
Zorunlu. Garantili siparişin görünen adı. UTF-8 kodlu olmalı ve en fazla 240 bayt boyutunda olmalıdır. |
status |
Garantili siparişin durum ayarları. |
updateTime |
Yalnızca çıkış. Garantili siparişin en son güncellendiği zaman damgası. Sistem tarafından atanır. Oluşturulan çıktının her zaman Z normalleştirileceği ve 0, 3, 6 veya 9 kesirli basamak kullanacağı RFC 3339'u kullanır. "Z" dışındaki ofsetler de kabul edilir. Örnekler: |
publisherName |
Zorunlu. Garantili siparişin yayıncı adı. UTF-8 kodlu olmalı ve en fazla 240 bayt boyutunda olmalıdır. |
readAccessInherited |
|
readAdvertiserIds[] |
Garantili siparişe okuma erişimi olan reklamverenlerin kimlikleri. Bu alan, ayarlanmışsa |
defaultAdvertiserId |
Yalnızca çıkış. Garantili siparişin varsayılan reklamvereninin kimliği. Varsayılan reklamveren, |
defaultCampaignId |
Garantili siparişe atanan varsayılan kampanyanın kimliği. Varsayılan kampanya, varsayılan reklamverene ait olmalıdır. |
Birlik alanı Garantili siparişe okuma/yazma erişimi olan iş ortağı veya reklamveren. |
|
readWritePartnerId |
Garantili siparişe okuma/yazma erişimi olan iş ortağı. |
readWriteAdvertiserId |
Garantili siparişe okuma/yazma erişimi olan reklamveren. Bu, garantili siparişin varsayılan reklamverenidir. |
GuaranteedOrderStatus
Garantili siparişin durum ayarları.
JSON gösterimi |
---|
{ "entityStatus": enum ( |
Alanlar | |
---|---|
entityStatus |
Garanti edilen siparişin yayınlanabilir olup olmadığı. Kabul edilen değerler |
entityPauseReason |
Bu garantili siparişin duraklatılması için kullanıcı tarafından sağlanan neden. UTF-8 kodlu ve en fazla 100 bayt uzunluğunda olmalıdır. Yalnızca |
configStatus |
Yalnızca çıkış. Garantili siparişin yapılandırma durumu. Kabul edilen değerler Garantili siparişler yayınlanmadan önce yapılandırılmalıdır (zorunludur alanları doldurun, reklam öğeleri seçin ve varsayılan bir kampanya seçin). Yapılandırma işlemi şu anda yalnızca kullanıcı arayüzü üzerinden gerçekleştirilebilir. |
GuaranteedOrderConfigStatus
Garantili sipariş için olası yapılandırma durumları.
Sıralamalar | |
---|---|
GUARANTEED_ORDER_CONFIG_STATUS_UNSPECIFIED |
Onay durumu bu sürümde belirtilmemiş veya bilinmiyor. |
PENDING |
Garantili siparişin başlangıç durumu. Bu durumdaki garantili siparişin yayınlanabilmesi için yapılandırılması gerekir. |
COMPLETED |
Alıcı garantili bir sipariş yapılandırdıktan sonraki durum. |
Yöntemler |
|
---|---|
|
Yeni bir garantili sipariş oluşturur. |
|
Garantili bir siparişin okunabilir reklamverenlerini düzenler. |
|
Garantili sipariş alır. |
|
Geçerli kullanıcının erişebildiği garantili siparişleri listeler. |
|
Mevcut bir garantili siparişi günceller. |