Yeni Sürüme Geç

Campaign Manager 360 API'nin yeni sürümleri düzenli olarak yayınlanır. Yeni sürümler yayınlandıkça önceki sürümler kullanımdan kaldırılır ve sonunda desteği sonlandırılır. Bir sürüm kullanımdan kaldırıldığında, bu sürümle ilgili tüm istekler hata döndürmeye başlar.

Kullandığınız sürümün desteği sonlandırıldıysa hizmet kesintilerini önlemek için en kısa sürede yükseltme yapmanız gerekir.

1. adım: Hangi sürümü kullandığınızı belirleyin

Hangi API sürümünü kullandığınızı aşağıdaki talimatları uygulayarak belirleyebilirsiniz. Çoğu durumda, API'ye dile özgü istemci kitaplıklarımızdan biri veya resmi bir entegrasyon aracılığıyla erişirsiniz.

Apps Komut Dosyası yeni düzenleyicisi

Apps Komut Dosyası'nın sürüm bilgileri, gelişmiş hizmetler iletişim kutusunda gösterilir:

  1. Apps Komut Dosyası Düzenleyicisi'nde Hizmet ekle'yi tıklayın.
  2. Kullanılabilir hizmetler listesinde Campaign Manager 360 API'yi bulun.
  3. Sürüm açılır listesinde seçilen değer, kullanılan Campaign Manager 360 API sürümüdür.

Apps Komut Dosyası eski düzenleyicisi

Apps Komut Dosyası'nın sürüm bilgileri, gelişmiş hizmetler iletişim kutusunda gösterilir:

  1. Apps Komut Dosyası Düzenleyicisi'nde Kaynaklar > Gelişmiş Google hizmetleri'ne gidin.
  2. Kullanılabilir hizmetler listesinde Campaign Manager 360 API'yi bulun.
  3. Sürüm açılır listesinde seçilen değer, kullanılan Campaign Manager 360 API sürümüdür.

C#

.NET için Google API İstemci Kitaplığı'nın sürüm bilgileri aşağıdaki yerlerde gösterilir:

  1. NuGet paket adına ve hizmet ad alanına dahil edilir. 
    Google.Apis.Dfareporting.v3_4
  2. DfareportingService öğesinin herkese açık bir özelliği kullanılarak gösterilir. 
    Console.WriteLine(DfareportingService.Version);

Java

Java için Google API İstemci Kitaplığı'nın sürüm bilgileri aşağıdaki yerlerde gösterilir:

  1. Maven artifactId'de belirtilir. 
    <dependency> <groupId>com.google.apis</groupId>
<artifactId>google-api-services-dfareporting</artifactId>
<version>v3.4-rev1-1.21.0</version>
</dependency>
  2. JAR dosya adına dahil edilir. 
    google-api-services-dfareporting-v3.4-rev1-1.21.0.jar
  3. Dfareporting öğesinin herkese açık bir özelliği kullanılarak gösterilir. 
    System.out.println(Dfareporting.DEFAULT_SERVICE_PATH);

PHP

PHP için Google API İstemci Kitaplığı'nın sürüm bilgileri, Google_Service_Dfareporting öğesinin herkese açık bir özelliği kullanılarak gösterilir: 

$service = new Google_Service_Dfareporting($client) print
$service->version;

Python

Python için Google API İstemci Kitaplığı (v1/v2) sürüm oluşturulmamıştır. Kullanılacak API sürümü, keşif oluşturucunun bağımsız değişkeni olarak belirtilir: 

discovery.build('dfareporting', 'v3.4', http=http)

Ruby

Ruby için Google API İstemci Kitaplığı'nın 0.9'dan önceki sürümleri sürüm kontrolüne tabi değildir. Kullanılacak API sürümü, hizmet oluşturucusunun bağımsız değişkeni olarak belirtilir: 

service = Google::APIClient::Service.new("dfareporting", "v3.4", { :application_name => "My application",
:application_version => '1.0.0', :authorization => authorization } )

Ruby için Google API İstemci Kitaplığı'nın 0.9 ve sonraki sürümlerinde sürüm, hizmet ad alanında kullanıma sunulur: 

Google.Apis.DfareportingV3_4

2. adım: Sürümünüzün durumunu belirleyin

Sürümünüzün durumunu belirlemek için desteğin sonlandırılma planını kontrol edin. Sürümünüz listede yoksa kullanımdan kaldırılmıştır ve artık desteklenmemektedir.

Sürümünüz listede yer alıyorsa Kullanımdan Kaldırılma Tarihi ve Kullanım Sonlandırma Tarihi sütunlarını kontrol edin:

  • Tarih yoksa sürümünüz tam olarak destekleniyordur.
  • Tarihler varsa sürümünüzün desteği sonlandırılmıştır ve belirtilen tarihte kullanımdan kaldırılacaktır.

Sürümünüzün desteği sonlandırıldıysa veya kullanımdan kaldırıldıysa hizmet kesintisi yaşamamak için daha yeni bir sürüme geçmeniz gerekir. Yükseltmeler arasındaki süreyi en üst düzeye çıkarmak için programda gösterilen en son sürüme (beta sürümleri hariç) geçmenizi öneririz.

3. adım: Sürümleri yükseltin

API'nin daha yeni bir sürümüne geçmek için entegrasyonunuzu güncellemeniz veya tercih ettiğiniz istemci kitaplığının güncellenmiş bir derlemesini edinmeniz gerekir. Bazı istemci kitaplıkları herhangi bir API sürümüyle çalışan tek bir derleme sağlarken diğerlerinin her sürüm için ayrı derlemeleri olduğunu unutmayın. Aşağıdaki listede, en yaygın kullanılan istemci kitaplıkları ve entegrasyonlarla ilgili genel yükseltme bilgileri verilmiştir.

Apps Komut Dosyası yeni düzenleyicisi

Google Apps Komut Dosyası, Campaign Manager 360 API'nin tüm sürümlerini destekler ve komut dosyası bazında kullanılacak sürümü seçmenize olanak tanır. Belirli bir komut dosyasının kullandığı sürümü değiştirmek için:

  1. Apps Komut Dosyası Düzenleyicisi'nde Hizmet ekle'yi tıklayın.
  2. Kullanılabilir hizmetler listesinde Campaign Manager 360 API'yi bulun.
  3. Sürüm açılır listesini kullanarak Campaign Manager 360 API sürümünü değiştirin.
  4. Değişikliklerinizi kaydetmek için Ekle'yi tıklayın.

Apps Komut Dosyası eski düzenleyicisi

Google Apps Komut Dosyası, Campaign Manager 360 API'nin tüm sürümlerini destekler ve komut dosyası bazında kullanılacak sürümü seçmenize olanak tanır. Belirli bir komut dosyasının kullandığı sürümü değiştirmek için:

  1. Apps Komut Dosyası Düzenleyicisi'nde Kaynaklar > Gelişmiş Google hizmetleri'ne gidin.
  2. Kullanılabilir hizmetler listesinde Campaign Manager 360 API'yi bulun.
  3. Sürüm açılır listesini kullanarak Campaign Manager 360 API sürümünü değiştirin.
  4. Değişikliklerinizi kaydetmek için Tamam'ı tıklayın.

C#

.NET için Google API İstemci Kitaplığı, Campaign Manager 360 API'nin her sürümü için ayrı derlemeler sağlar ve bu derlemeler NuGet üzerinden dağıtılır. İstemci kitaplığını, kullanmak istediğiniz API sürümüne karşılık gelen bir sürüme güncelleyin.

Ayrıntılı yükleme talimatları veya alternatif indirme seçenekleri için istemci kitaplığı belgelerine bakın.

Java

Java için Google API İstemci Kitaplığı, Maven üzerinden dağıtılan Campaign Manager 360 API'nin her sürümü için ayrı derlemeler sağlar. İstemci kitaplığını, kullanmak istediğiniz API sürümüne karşılık gelen bir sürüme güncelleyin.

Ayrıntılı yükleme talimatları veya alternatif indirme seçenekleri için istemci kitaplığı belgelerine bakın.

PHP

PHP için Google API İstemci Kitaplığı, Packagist üzerinden dağıtılan Campaign Manager 360 API'nin her sürümü için ayrı derlemeler sağlar. Kullanmak istediğiniz API sürümüne karşılık gelen istemci kitaplığı sürümüne güncelleyin.

Ayrıntılı yükleme talimatları veya alternatif indirme seçenekleri için istemci kitaplığı belgelerine bakın.

Python

Python için Google API İstemci Kitaplığı'nın (v1/v2) her derlemesi, Campaign Manager 360 API'nin tüm sürümlerini destekler. Campaign Manager 360 API'nin yeni bir sürümüne geçmek için keşif oluşturucuya bağımsız değişken olarak iletilen sürüm dizesini güncelleyin: 

discovery.build('dfareporting', 'v3.4', http=http)
 Ayrıntılı yükleme talimatları veya alternatif indirme seçenekleri için istemci kitaplığı belgelerine bakın.

Ruby

Ruby için Google API İstemci Kitaplığı v0.8 ve daha eski sürümleri, Campaign Manager 360 API'nin tüm sürümlerini destekler. Campaign Manager 360 API'nin yeni bir sürümüne geçmek için hizmet oluşturucuya bağımsız değişken olarak iletilen sürüm dizesini güncelleyin: 

service = Google::APIClient::Service.new("dfareporting", "v3.4",
    {
      :application_name => "My application",
      :application_version => '1.0.0',
      :authorization => authorization
    }
)
 Ruby için Google API İstemci Kitaplığı v0.9+, RubyGems üzerinden dağıtılan Campaign Manager 360 API'nin her sürümü için ayrı derlemeler sağlar. Kullanmak istediğiniz API sürümüne karşılık gelen istemci kitaplığı sürümüne güncelleyin. Ayrıntılı yükleme talimatları veya alternatif indirme seçenekleri için istemci kitaplığı belgelerine bakın.

REST

API'yi doğrudan HTTPS kullanarak çağırıyorsanız isteklerinizin uç noktasını yeni API sürüm numarasını kullanacak şekilde güncelleyin.

Örneğin, v4 alanından v5 alanına geçiş yaparken temel URL'yi şu şekilde değiştirirsiniz: 

https://dfareporting.googleapis.com/dfareporting/v4/...
 to: 
https://dfareporting.googleapis.com/dfareporting/v5/...

4. adım: Adres sürümü farklılıklarını ele alın

Yeni API sürümleri, mümkün olduğunda geriye dönük uyumlu olacak şekilde tasarlanır. Ancak bazı güncellemeler, kodunuzu değiştirmenizi gerektiren önemli değişiklikler içerebilir. Bu değişiklikler sürüm notlarında ayrıntılı olarak açıklanmıştır.

Taşıma işlemi sırasında, mevcut sürümünüz ile yükseltme yapacağınız sürüm arasındaki her sürümün sürüm notlarını inceleyin. Aşağıdaki bölümlere özellikle dikkat edin:

  • Yeni özellikler: Yeni eklenen işlevler. Bunlar için taşıma sırasında kod değişikliği yapılması gerekmez.
  • Kullanımdan kaldırılanlar: API'den kaldırılan işlevler. Değiştirilen işlevler kullanıma sunulduğunda belirtilir.
  • Bilinen sorunlar: Yeniden adlandırılan alanlar veya yöntemler ya da değiştirilen doğrulama mantığı gibi mevcut işlevlerde yapılan değişiklikler.

Uygulamanız Desteği sonlandırılanlar veya Bilinen sorunlar bölümlerinde listelenen işlevleri kullanıyorsa kodunuzu bu değişiklikleri ele alacak şekilde güncellemeniz gerekir.

Haberdar olun

API sürümleri, desteği sonlandırılan özellikler ve kullanımdan kaldırılan özellikler hakkında ilk bilgi sahibi olmak için Google Ads geliştirici blogunu düzenli olarak takip edin.