8 Eylül 2025'ten itibaren her yeni satır öğesinin, Avrupa Birliği (AB) siyasi reklamları yayınlayıp yayınlamayacağını beyan etmesi gerekecek. Bildirim içermeyen Display & Video 360 API ve SDF yüklemeleri başarısız olur. Entegrasyonunuzu bu beyanı yapacak şekilde güncelleme hakkında daha fazla bilgi için desteği sonlandırma sayfamıza bakın.
Bir reklamverendeki kampanya siparişlerini listeler.
Sıralama, orderBy parametresi tarafından tanımlanır. filter ile entityStatus belirtilmezse ENTITY_STATUS_ARCHIVED içeren kampanya siparişleri sonuçlara dahil edilmez.
HTTP isteği
GET https://displayvideo.googleapis.com/v3/advertisers/{advertiserId}/insertionOrders
İstenen sayfa boyutu. 1 ile 100 arasında olmalıdır. Belirtilmemişse varsayılan olarak 100 olur. Geçersiz bir değer belirtilirse INVALID_ARGUMENT hata kodunu döndürür.
pageToken
string
Sunucunun döndürmesi gereken bir sonuç sayfasını tanımlayan jeton. Genellikle bu, insertionOrders.list yöntemine yapılan önceki çağrıdan döndürülen nextPageToken değerini ifade eder. Belirtilmemişse sonuçların ilk sayfası döndürülür.
orderBy
string
Listeyi sıralamak için kullanılacak alan. Kabul edilen değerler şunlardır:
"displayName" (varsayılan)
"entityStatus"
"updateTime"
Varsayılan sıralama düzeni artan düzendir. Bir alan için azalan sıra belirtmek üzere alan adına "desc" soneki eklenmelidir. Örnek: displayName desc.
filter
string
Kampanya siparişi alanlarına göre filtrelemeye olanak tanır.
Desteklenen söz dizimi:
Filtre ifadeleri bir veya daha fazla kısıtlamadan oluşur.
Kısıtlamalar, AND veya OR mantıksal operatörleriyle birleştirilebilir. Kısıtlama dizisi, AND değerini dolaylı olarak kullanır.
updateTime alanında GREATER THAN OR EQUAL TO (>=) veya LESS THAN OR EQUAL TO (<=) operatörleri kullanılmalıdır.
Diğer tüm alanlar EQUALS (=) operatörünü kullanmalıdır.
Desteklenen alanlar:
campaignId
displayName
entityStatus
updateTime (ISO 8601 biçiminde giriş veya YYYY-MM-DDTHH:MM:SSZ)
Örnekler:
Bir kampanya kapsamındaki tüm kampanya siparişleri: campaignId="1234"
Bir reklamverenin altındaki tüm ENTITY_STATUS_ACTIVE veya ENTITY_STATUS_PAUSED kampanya siparişleri: (entityStatus="ENTITY_STATUS_ACTIVE" OR
entityStatus="ENTITY_STATUS_PAUSED")
Güncelleme zamanı 2020-11-04T18:54:47Z (ISO 8601 biçiminde) veya bu tarihten önce olan tüm kampanya siparişleri: updateTime<="2020-11-04T18:54:47Z"
Güncelleme zamanı 2020-11-04T18:54:47Z (ISO 8601 biçimi) veya daha büyük olan tüm kampanya siparişleri: updateTime>="2020-11-04T18:54:47Z"
Bu alanın uzunluğu en fazla 500 karakter olmalıdır.
Sonuçların bir sonraki sayfasını almak için kullanılan jeton. Sonuçların bir sonraki sayfasını almak için insertionOrders.list yönteminin sonraki çağrısında bu değeri pageToken alanına iletin.
[null,null,["Son güncelleme tarihi: 2025-07-25 UTC."],[[["\u003cp\u003eLists insertion orders, filterable by campaign ID, display name, entity status, and update time, within a specified advertiser.\u003c/p\u003e\n"],["\u003cp\u003eSupports pagination to retrieve large result sets via \u003ccode\u003epageToken\u003c/code\u003e and \u003ccode\u003epageSize\u003c/code\u003e parameters.\u003c/p\u003e\n"],["\u003cp\u003eAllows sorting results by display name, entity status, or update time, with optional descending order.\u003c/p\u003e\n"],["\u003cp\u003eResponse provides a list of insertion orders and a token for fetching the next page if available.\u003c/p\u003e\n"],["\u003cp\u003eRequires authorization with the \u003ccode\u003ehttps://www.googleapis.com/auth/display-video\u003c/code\u003e scope.\u003c/p\u003e\n"]]],["This API endpoint lists insertion orders for a specified advertiser using a GET request. You must provide the `advertiserId` as a path parameter. You can filter the results using the `filter` query parameter, sort them using `orderBy`, and control pagination with `pageSize` and `pageToken`. The response includes a list of `insertionOrders` and a `nextPageToken` for pagination. Filtering allows for logical operators and various fields, including `entityStatus` and `updateTime`. The request body must be empty.\n"],null,[]]
