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ıra, orderBy parametresiyle tanımlanır. filter x entityStatus boyutu belirtilmemişse ENTITY_STATUS_ARCHIVED boyutundaki reklam öğeleri sonuçlara dahil edilmez.
HTTP isteği
GET https://displayvideo.googleapis.com/v3/advertisers/{advertiserId}/creatives
Zorunlu. Reklam öğelerinin listeleneceği reklamverenin kimliği.
Sorgu parametreleri
Parametreler
pageSize
integer
İstenen sayfa boyutu. 1 ile 200 arasında olmalıdır. Belirtilmezse 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 sonuç sayfasını tanımlayan bir jeton. Bu genellikle creatives.list yöntemine yapılan önceki çağrıdan döndürülen nextPageToken değeridir. Belirtilmezse sonuçların ilk sayfası döndürülür.
orderBy
string
Listenin sıralanacağı alan. Kabul edilen değerler şunlardır:
creativeId (varsayılan)
createTime
mediaDuration
dimensions (önce genişliğe, sonra yüksekliğe göre sıralar)
Varsayılan sıralama düzeni artandır. Bir alan için azalan sırayı belirtmek üzere alan adına "desc" soneki eklenmelidir. Örnek: createTime desc.
filter
string
Reklam öğesi 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. Bir kısıtlama dizisi örtülü olarak AND kullanır.
lineItemIds alanında HAS (:) operatörü kullanılmalıdır.
updateTime alanı, GREATER THAN OR EQUAL TO (>=) veya LESS THAN OR EQUAL TO (<=) operatörlerini kullanmalıdır.
Diğer tüm alanlarda EQUALS (=) operatörü kullanılmalıdır.
entityStatus, minDuration, maxDuration, updateTime ve dynamic alanları için en fazla bir kısıtlama olabilir.
Desteklenen alanlar:
approvalStatus
creativeId
creativeType
dimensions ({width}x{height} biçiminde giriş)
dynamic
entityStatus
exchangeReviewStatus ({exchange}-{reviewStatus} biçiminde giriş)
lineItemIds
maxDuration ({duration}s biçiminde giriş. Yalnızca saniyeler desteklenir)
minDuration ({duration}s biçiminde giriş. Yalnızca saniyeler desteklenir)
updateTime (ISO 8601 biçiminde giriş veya YYYY-MM-DDTHH:MM:SSZ)
Notlar:
updateTime için bir reklam öğesi kaynağının alan değeri, reklam öğesinin en son güncellendiği zamanı yansıtır.Bu, sistem tarafından yapılan güncellemeleri (ör. reklam öğesi inceleme güncellemeleri) içerir.
Örnekler:
Tüm doğal reklam öğeleri: creativeType="CREATIVE_TYPE_NATIVE"
300x400 veya 50x100 boyutlarındaki tüm etkin reklam öğeleri: entityStatus="ENTITY_STATUS_ACTIVE" AND (dimensions="300x400"
OR dimensions="50x100")
AdX veya AppNexus tarafından onaylanan, minimum süresi 5 saniye ve 200 ms olan tüm dinamik reklam öğeleri: dynamic="true" AND minDuration="5.2s" AND
(exchangeReviewStatus="EXCHANGE_GOOGLE_AD_MANAGER-REVIEW_STATUS_APPROVED"
OR exchangeReviewStatus="EXCHANGE_APPNEXUS-REVIEW_STATUS_APPROVED")
Satır öğesi kimliği 1 veya 2 ile ilişkilendirilmiş tüm video reklam öğeleri: creativeType="CREATIVE_TYPE_VIDEO" AND (lineItemIds:1 OR lineItemIds:2)
Birden fazla reklam öğesi kimliğine göre reklam öğesi bulma: creativeId=1 OR creativeId=2
Güncelleme zamanı 2020-11-04T18:54:47Z'den (ISO 8601 biçimi) büyük veya bu değere eşit olan tüm reklam öğeleri: updateTime>="2020-11-04T18:54:47Z"
Sonuçların sonraki sayfasını almak için kullanılan jeton. Sonraki sonuç sayfasını almak için ListCreativesRequest yöntemine yapılan sonraki çağrıda bu değeri pageToken alanına iletin. Bu alan boşsa son sayfadır.
[[["Anlaması kolay","easyToUnderstand","thumb-up"],["Sorunumu çözdü","solvedMyProblem","thumb-up"],["Diğer","otherUp","thumb-up"]],[["İhtiyacım olan bilgiler yok","missingTheInformationINeed","thumb-down"],["Çok karmaşık / çok fazla adım var","tooComplicatedTooManySteps","thumb-down"],["Güncel değil","outOfDate","thumb-down"],["Çeviri sorunu","translationIssue","thumb-down"],["Örnek veya kod sorunu","samplesCodeIssue","thumb-down"],["Diğer","otherDown","thumb-down"]],["Son güncelleme tarihi: 2025-09-09 UTC."],[[["\u003cp\u003eLists creatives, ordered by \u003ccode\u003ecreativeId\u003c/code\u003e, \u003ccode\u003ecreateTime\u003c/code\u003e, \u003ccode\u003emediaDuration\u003c/code\u003e, or \u003ccode\u003edimensions\u003c/code\u003e, for a given advertiser.\u003c/p\u003e\n"],["\u003cp\u003eFilter creatives by \u003ccode\u003eapprovalStatus\u003c/code\u003e, \u003ccode\u003ecreativeId\u003c/code\u003e, \u003ccode\u003ecreativeType\u003c/code\u003e, \u003ccode\u003edimensions\u003c/code\u003e, \u003ccode\u003edynamic\u003c/code\u003e, \u003ccode\u003eentityStatus\u003c/code\u003e, \u003ccode\u003eexchangeReviewStatus\u003c/code\u003e, \u003ccode\u003elineItemIds\u003c/code\u003e, \u003ccode\u003emaxDuration\u003c/code\u003e, \u003ccode\u003eminDuration\u003c/code\u003e, or \u003ccode\u003eupdateTime\u003c/code\u003e.\u003c/p\u003e\n"],["\u003cp\u003eArchived creatives are excluded unless explicitly filtered for.\u003c/p\u003e\n"],["\u003cp\u003eResults are paginated, with control over page size and retrieval of subsequent pages using tokens.\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"]]],[],null,[]]
