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.
Sıralama, orderBy parametresi tarafından tanımlanır. filter ile entityStatus arasında bir değer belirtilmezse ENTITY_STATUS_ARCHIVED içeren kampanyalar sonuçlara dahil edilmez.
HTTP isteği
GET https://displayvideo.googleapis.com/v3/advertisers/{advertiserId}/campaigns
İstenen sayfa boyutu. 1 ile 200 arasında olmalıdır. Belirtilmemişse varsayılan olarak 100 olur.
pageToken
string
Sunucunun döndürmesi gereken bir sonuç sayfasını tanımlayan jeton. Genellikle bu, campaigns.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 alanlarına göre filtreleme yapılmasına 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 reklamverenin altındaki tüm ENTITY_STATUS_ACTIVE veya ENTITY_STATUS_PAUSED kampanyaları: (entityStatus="ENTITY_STATUS_ACTIVE" OR
entityStatus="ENTITY_STATUS_PAUSED")
Güncelleme zamanı 2020-11-04T18:54:47Z (ISO 8601 biçimi) veya daha az olan tüm kampanyalar: 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 kampanyalar: 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 campaigns.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 campaigns within a specified advertiser, allowing for filtering and sorting.\u003c/p\u003e\n"],["\u003cp\u003eRetrieves paginated results, with options to control page size and navigate through pages.\u003c/p\u003e\n"],["\u003cp\u003eSupports filtering by campaign attributes such as ID, display name, entity status, and update time.\u003c/p\u003e\n"],["\u003cp\u003eRequires authorization with specific OAuth scopes for access.\u003c/p\u003e\n"],["\u003cp\u003eReturns a list of campaigns with details and a token for retrieving subsequent pages if available.\u003c/p\u003e\n"]]],["This describes how to list campaigns for an advertiser using a `GET` request to the specified endpoint. Key actions include using the `advertiserId` path parameter and optional query parameters like `pageSize`, `pageToken`, `orderBy`, and `filter`. `orderBy` allows sorting by `displayName`, `entityStatus`, or `updateTime`. The response includes a list of campaigns and a `nextPageToken` for pagination. Filters can be applied to fields such as `campaignId`, `displayName`, `entityStatus`, and `updateTime`. The request body must be empty.\n"],null,[]]