Display & Video 360 API v4'ten v5'e geçiş

Son güncelleme: 22.10.2026

Uygulamanızı taşıma

v4'ten v5'e geçiş yapmak için uç nokta URL'lerinizi v5'i çağıracak şekilde güncellemeniz, uygulamanızı zarar veren değişiklikleri hesaba katacak şekilde güncellemeniz ve entegrasyonunuza fayda sağlayabilecek yeni özellikleri incelemeniz gerekir.

API çağrılarınızı v4'ten v5'e güncelleme

v4 yerine v5'i kullanmak için isteklerinizi yeni v5 uç noktalarını kullanacak şekilde güncellemeniz gerekir.

Örneğin, advertisers.get yöntemini v4 ile çağırmak için aşağıdaki URL'yi kullanın:

GET https://displayvideo.googleapis.com/v4/advertisers/advertiserId

5. sürüm için URL'yi aşağıdaki şekilde güncelleyin:

GET https://displayvideo.googleapis.com/v5/advertisers/advertiserId

API'ye istek göndermek için istemci kitaplığı kullanıyorsanız istemci kitaplığının en son sürümünü kullanın ve yapılandırmanızı 5. sürümü kullanacak şekilde güncelleyin.

Gerekli değişiklikleri yapın

Display & Video 360 API v5, zarar veren değişiklikler içerir. Aşağıdaki talimatları inceleyin ve Display & Video 360 API'yi mevcut kullanımınızla ilgili gerekli değişiklikleri yapın.

Display & Video 360 API v4 ve v5 arasındaki farkların kapsamlı bir listesi için sürüm notlarını inceleyin.

Envanter kaynağı alma ve hedefleme işlemlerini yeni kimlikleri ve türleri kullanacak şekilde güncelleme

Display & Video 360 API v5, envanter kaynağı anlaşmalarının ve açık artırma paketlerinin nasıl alındığını ve hedeflendiğini değiştirir.

4. sürümde, inventorySources hizmeti kullanılarak alınan InventorySource kaynakları hem envanter kaynağı anlaşmalarını hem de açık artırma paketlerini temsil eder. Hem anlaşmalar hem de açık artırma paketleri TARGETING_TYPE_INVENTORY_SOURCE kullanılarak hedeflenir.

5. sürümde, envanter kaynağı anlaşmaları ve açık artırma paketleri ayrı ayrı işlenir:

Bu güncelleme, mevcut anlaşmalar ve açık artırma paketleri için kullanılan kimlikleri değiştirir. Bu nedenle, taşıma işleminden sonra önceden önbelleğe alınmış InventorySource kaynak kimliklerini kullanamazsınız.

Bu değişikliklere ek olarak v5, envanter kaynaklarının erişimcilerini oluşturma, güncelleme ve düzenleme özelliğini de kaldırır.

Talep Yaratma ve YouTube kaynakları için kitle hedefleme mantığını güncelleme

Display & Video 360 API 5. sürüm, Talep Yaratma ve YouTube kaynakları için kitle hedefleme mantığını, hedeflenen her kitle listesi için ayrı atanmış seçenekler kullanacak şekilde günceller.

4. sürümde tüm kitle hedefleme işlemleri TARGETING_TYPE_AUDIENCE_GROUP kullanılarak yönetilir.

5. sürümde, Talep Yaratma ve YouTube reklam gruplarına atanan kitle hedefleme, kitle türüne bağlı olarak aşağıdaki hedefleme türlerinden biri ve AssignedTargetingOption kaynak alanları kullanılarak yönetilir:

Satır öğeleri, tüm türler için kitle hedeflemeyi yönetmek üzere tek bir TARGETING_TYPE_AUDIENCE_GROUP AssignedTargetingOption kullanmaya devam edecek.

Müşteri Eşleştirme kitle yönetimi için Data Manager API'ye geçiş yapın

Display & Video 360 API 5 sürümü, aşağıdaki yöntemleri kaldırarak Müşteri Eşleştirme kitlelerinin üyeliğini oluşturma ve yönetme özelliğini kaldırır:

  • firstPartyAndPartnerAudiences.create
  • firstPartyAndPartnerAudiences.editCustomerMatchMembers
  • firstPartyAndPartnerAudiences.patch

Müşteri Eşleştirme kitlelerini yönetmeye devam etmek için iş akışlarınızı Data Manager API'yi kullanacak şekilde yükseltin.

Dijital ev dışı kampanya siparişlerini alma desteği ekleme

Display & Video 360 API v5, dijital ev dışı kampanya siparişlerini alma desteği ekler.

Reklamverenleriniz dijital ev dışı reklamcılık kullanıyorsa InsertionOrder kaynaklarının OUT_OF_HOME değerine sahip insertionOrderType alan değeriyle dahil edilmesini bekleyerek advertisers.insertionOrders.list yöntemini çağıran tüm entegrasyonları yükseltin.

5. sürümde, dijital ev dışı kampanya siparişleri kapsamındaki satır öğeleri, 4. sürümde olduğu gibi alınmaya devam edecek.

Adloox referanslarını Peer39 olarak güncelleme

5. sürümde, Adloox (Scope3 olarak da bilinir) ile Display & Video 360 üçüncü taraf marka uygunluğu entegrasyonuna referans veren alanlar ve enum değerleri Peer39 olarak güncellendi:

YouTube satır öğeleri, reklam grupları ve reklamlar için alanları güncelleme

5. sürümde LineItem, AdGroup ve AdGroupAd kaynaklarındaki çeşitli alanlar kaldırıldı veya güncellendi. Kaynak alma mantığınızı bu değişiklikleri hesaba katacak şekilde güncelleyin.

LineItem kaynağında:

LineItem ve AdGroup kaynaklarında:

AdGroupAd kaynağında:

Desteği sonlandırılan enum değerlerine yapılan referansları kaldırma

5. sürümde, daha önce desteği sonlandırılan enum değerleri tamamen kaldırıldı. API isteklerinde bu değerlerin kullanılması v4'te hataya neden olurken bu değişiklikle birlikte v5 istemci kitaplıklarından bu değerlere yapılan tüm referanslar kaldırılır. Kodunuzda bu desteği sonlandırılan değerlere yapılan referanslar, v5'e yükseltme sırasında hatalara neden olabilir.

Etkilenen değerlere sahip enum türleri arasında ContentRatingTier, GoogleAudienceType, SdfVersion ve SensitiveCategory bulunur. Kaldırılan tüm enum değerlerinin kapsamlı bir listesi için sürüm notlarımıza bakın.

Yeni özellikleri inceleme

Zarar veren değişikliklerin yanı sıra v5'te aşağıdaki yeni özellikler de sunulmaktadır:

  • TARGETING_TYPE_YOUTUBE_VIDEO ve TARGETING_TYPE_YOUTUBE_CHANNEL hedefleme türleri kapsamında reklamveren düzeyinde YouTube videosu ve kanal dışlama hedeflemesinin tam yönetimi. 4. sürümde bu hedefleme salt okunurdu.
  • Dijital ev dışı InsertionOrder kaynakları oluşturma olanağı.
  • AdGroup alanları adSource ve creativeAssignments ile AdGroupAd alanı parentCreativeId eklenerek reklam oluşturmak için atanmış reklam öğelerini kullanan reklam grupları için destek.
  • LookalikeAudience kaynakları oluşturma ve alma özelliği.
  • AdGroupAd kaynağında yeni bir containsSyntheticMedia alanı.