v3'ten v4'e taşıma

Son güncelleme: 2025-07-31

Uygulamanızı taşıma

v3'ten v4'e geçiş için uç nokta URL'lerinizi v4'ü çağıracak şekilde güncellemeniz ve uygulamanızı, önemli değişiklikleri hesaba katacak şekilde güncellemeniz gerekir.

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

v3 yerine v4'ü kullanmak için isteklerinizi yeni v4 uç noktalarını kullanacak şekilde güncelleyin.

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

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

v4 için URL'yi aşağıdaki şekilde güncelleyin:

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

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

Gerekli değişiklikleri yapın

4. sürümde bir dizi zarar veren değişiklik yapıyoruz. Aşağıdaki talimatları inceleyin ve Display & Video 360 API'yi mevcut kullanımınızla ilgili gerekli değişiklikleri yapın.

Birinci ve üçüncü taraf kitle kaynakları ile ilgili hedefleme hakkında güncelleme çağrıları

FirstAndThirdPartyAudience kaynak, FirstPartyAndPartnerAudience kaynaklarıyla değiştirildi.

Bu değişiklik için aşağıdakileri güncellemeniz gerekir:

• Yeni FirstPartyAndPartnerAudience kaynağını kullanmak için FirstAndThirdPartyAudience kaynaklarına yapılan referanslar.
• v3 hizmetindeki yöntemlere yapılan mevcut istekler firstAndThirdPartyAudiences yeni v4 hizmetine firstPartyAndPartnerAudiences yönlendirilir.
• 100 ila 5.000 öğe içeren firstPartyAndPartnerAudiences.list istekleri için varsayılan sayfa boyutu beklentileri.
• Yeni FirstPartyAndPartnerAudienceType enum türü kullanılarak v3 firstAndThirdPartyAudienceType alanından yeni v4 firstPartyAndPartnerAudienceType alanına yapılan referanslar. Eski değerler aşağıdaki yeni değerlere karşılık gelir:
  • FIRST_AND_THIRD_PARTY_AUDIENCE_TYPE_FIRST_PARTY - TYPE_FIRST_PARTY
  • FIRST_AND_THIRD_PARTY_AUDIENCE_TYPE_THIRD_PARTY - TYPE_PARTNER

• AudienceType enum değeri LICENSED ile ilgili referanslar yerine aşağıdaki yeni ve daha spesifik değerlerden birini kullanın:

  • THIRD_PARTY
  • COMMERCE
  • LINEAR

• AssignedTargetingOption kaynaklarına yapılan referanslar, TargetingType TARGETING_TYPE_AUDIENCE_GROUP ile değiştirilerek AudienceGroupAssignedTargetingOptionDetails içindeki v3 alanları aşağıdaki yeni v4 alanlarıyla değiştirilecek:

  • excludedFirstPartyAndPartnerAudienceGroup ile excludedFirstAndThirdPartyAudienceGroup
  • includedFirstPartyAndPartnerAudienceGroups ile includedFirstAndThirdPartyAudienceGroups

Mevcut reklam grubu toplu liste hedefleme isteklerini güncelleme

advertisers.adGroups.bulkListAdGroupAssignedTargetingOptions yeniden adlandırıldı advertisers.adGroups.bulkListAssignedTargetingOptions. Mevcut isteklerinizi yeni yöntem adını kullanacak şekilde güncelleyin.

Kampanya siparişleri oluştururken optimizasyon hedefi ekleme

optimizationObjective alanı artık InsertionOrder kaynağında zorunlu bir alandır. Bu alanın ayarlandığını doğrulamak için advertisers.insertionOrders.create isteklerinizi güncelleyin.

Reklam öğesi kaynağı alanına yapılan referansları kaldırın publisherReviewStatuses

publisherReviewStatuses alanı, Haziran 2024'te kullanımdan kaldırıldıktan sonra Creative kaynağı altındaki ReviewStatusInfo nesnesinden kaldırıldı.