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 eski sürümlerin desteği sonlandırılır ve kullanımdan kaldırılır. Bir sürüm kullanımdan kaldırıldığında, bu sürüme yönelik tüm istekler hata döndürmeye başlar.

Kullandığınız API sürümünün desteği sonlandırıldıysa planlanan kullanımdan kaldırma tarihinden önce daha yeni bir sürüme geçmeniz gerekir. Bu kılavuzda, kullandığınız API sürümünün desteğinin sonlandırılıp sonlandırılmadığını nasıl belirleyeceğinizle ilgili ayrıntılar ve önerilen taşıma adımları sağlanmaktadır.

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

Desteği sonlandırılmış bir Campaign Manager 360 API sürümünü kullanıyor olabileceğinden şüphelendiğiniz bir uygulamayı sürdürüyorsanız öncelikle hangi sürümü kullandığınızı doğrulamanız gerekir. Çoğu durumda API'ye dile özgü istemci kitaplıklarımızdan biri veya resmi bir entegrasyon üzerinden erişirsiniz. Bu istemci kitaplıkları ve entegrasyonlar tarafından kullanılan API sürümünü bulma talimatlarını aşağıda bulabilirsiniz:

Apps Komut Dosyası'nın 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üzenleyicisinde Hizmet ekle'yi tıklayın.
  2. Mevcut hizmetler listesinde Campaign Manager 360 API'yi bulun.
  3. Sürüm açılır listesinde seçilen değer, şu anda 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üzenleyicisinde Kaynaklar > Gelişmiş Google hizmetleri'ne gidin.
  2. Mevcut hizmetler listesinde Campaign Manager 360 API'yi bulun.
  3. Sürüm açılır listesinde seçilen değer, şu anda 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 paketi adına ve hizmet ad alanına dahildir. 
    Google.Apis.Dfareporting.v3_4
  2. DfareportingService'nin herkese açık bir mülkü aracılığıyla yayınlanır. 
    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'inde 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'nin herkese açık bir mülkü aracılığıyla yayınlanır. 
    System.out.println(Dfareporting.DEFAULT_SERVICE_PATH);

PHP

PHP için Google API İstemci Kitaplığı'nın sürüm bilgileri, Google_Service_Dfareporting'nin herkese açık bir mülkü aracılığıyla gösterilir: 

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

Python

Python için Google API İstemci Kitaplığı (v1/v2) sürüm numarası içermez. 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

0,9'dan eski Ruby için Google API İstemci Kitaplığı sürümleri sürüm numarası içermez. Kullanılacak API sürümü, hizmet kurucusunun 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 istemci kitaplığının 0,9 ve sonraki sürümlerinde sürüm, hizmet ad alanında gösterilir: 

Google.Apis.DfareportingV3_4

Daha sonra ihtiyacınız olacağından kullandığınız sürümü not edin.

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

Destek sonu programı, şu anda desteklenen her bir sürümün durumunu listeler. Bu listede sürümünüzü bulun ve durumunu aşağıdaki şekilde belirleyin:

  1. Destek sonu tarihi ve Destek sonu tarihi sütunlarında tarih yoksa tamamen desteklenen bir sürümü kullanıyorsunuz demektir.
  2. Tarihler listeleniyorsa kullandığınız sürümün desteği sonlandırılmıştır ve belirtilen tarihte kullanımdan kaldırılacaktır.
  3. Sürümünüz listede yoksa kullanımdan kaldırılmış ve artık desteklenmemektedir.

Yukarıdaki 2. veya 3. maddeye uyuyorsanız hizmette kesinti yaşamamak için daha yeni bir sürüme geçmeniz gerekir. Destek sonlandırma takvimi tablosunun en üstünde listelenen en son sürüme geçmeniz önerilir (beta sürümleri hariç). Bu sayede, yükseltmeler arasında maksimum süreyi elde edebilirsiniz.

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

Taşıma işlemi yapmanız gerektiğini belirlediyseniz sonraki adım, entegrasyonunuzu güncellemek veya tercih ettiğiniz istemci kitaplığının güncellenmiş bir derlemesini edinmektir. Bazı istemci kitaplıklarının yalnızca herhangi bir API sürümüyle çalışan tek bir derleme sunabileceğini, diğerlerinin ise her sürüm için ayrı derlemelere sahip olacağını unutmayın. Aşağıdaki listede, en yaygın olarak kullanılan istemci kitaplıkları ve entegrasyonlarıyla ilgili genel yükseltme bilgileri verilmiştir.

Apps Komut Dosyası'nın yeni düzenleyicisi

Google Apps Script, Campaign Manager 360 API'nin tüm sürümlerini destekler ve kullanılacak sürümü komut dosyası bazında 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üzenleyicisinde Hizmet ekle'yi tıklayın.
  2. Mevcut hizmetler listesinde Campaign Manager 360 API'yi bulun.
  3. Sürüm açılır menüsünü kullanarak kullanılan 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 Script, Campaign Manager 360 API'nin tüm sürümlerini destekler ve kullanılacak sürümü komut dosyası bazında 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üzenleyicisinde Kaynaklar > Gelişmiş Google hizmetleri'ne gidin.
  2. Mevcut hizmetler listesinde Campaign Manager 360 API'yi bulun.
  3. Sürüm açılır menüsünü kullanarak kullanılan 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 Nuget üzerinden dağıtılan ayrı derlemeler sağlar.

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

Java

Java için Google API İstemci Kitaplığı, Campaign Manager 360 API'nin her sürümü için Maven aracılığıyla dağıtılan ayrı derlemeler sağlar.

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

PHP

PHP için Google API İstemci Kitaplığı, Campaign Manager 360 API'sinin her sürümü için Packagist üzerinden dağıtılan ayrı derlemeler sağlar.

Ayrıntılı kurulum 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. Discovery oluşturucuya bağımsız değişken olarak iletilen sürüm dizesini güncellemeniz yeterlidir: 

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

Ruby

Ruby için Google API İstemci Kitaplığı 0.8 ve önceki sürümleri, Campaign Manager 360 API'nin tüm sürümlerini destekler. Hizmet kurucusuna bağımsız değişken olarak iletilen sürüm dizesini güncellemeniz yeterlidir: 

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ığı 0.9 ve sonraki sürümleri, Campaign Manager 360 API'nin her sürümü için RubyGems aracılığıyla dağıtılan ayrı derlemeler sağlar. Ayrıntılı kurulum talimatları veya alternatif indirme seçenekleri için istemci kitaplığı belgelerine bakın.

4. Adım: Adres sürümlerindeki farklılıklar

Yeni sürümlerimizi geriye dönük uyumlu hale getirmeye çalışıyoruz. Bu, API sürümleri arasında geçiş yaparken kodunuzda değişiklik yapmanız gerekmeyeceği anlamına gelir. Bu mümkün olmadığında, geliştiricilerin işlem yapması gereken değişiklikleri (önemli değişiklikler olarak da bilinir) sürüm notlarımızda duyururuz.

Bu noktada, başlangıç yaptığınız sürümden sonraki sürümden (daha önceki bir bölümde not aldığınız sürüm) başlayarak yükselttiğiniz sürüme kadar olan sürümlerin tümünü içeren sürüm notlarımızı incelemeniz gerekir. Sürüm notlarının bölümleri aşağıdaki şekilde yorumlanmalıdır:

  • Yeni özellikler: Yeni eklenen işlevler.
  • Destek sonlandırılan API'ler: API'den kaldırılan işlevler. Kullanıma sunulduğunda değişim işlevi bu bölümde ele alınacaktır.
  • Bilinen sorunlar: Eklemeler veya kaldırmalar dışındaki değişiklikler. Örneğin, bu bölümde yeniden adlandırılmış alanlar veya yöntemler ya da değişen doğrulama mantığı yer alabilir.

Yeni özellikler bölümündeki işlevler için kod değişikliği gerekmez ve şu anda göz ardı edilebilir. Eklediğimiz bir özelliği denemek isterseniz bu bölüme daha sonra geri dönebilirsiniz.

Öte yandan, Destek sonlandırılan ürünler veya Bilinen sorunlar bölümlerinde değişiklik görürseniz işlem yapmanız gerekebilir. Kaldırılan veya değiştirilen işlevlerden herhangi birinin uygulamanız tarafından kullanılıp kullanılmadığını belirlemek için kodunuzu aramanız gerekir. Bu durumda, bu değişiklikleri gidermek için kodunuzda güncelleme yapmanız gerekir.

Haberdar olun

Daha önce de belirtildiği gibi, Campaign Manager 360 API'nin yeni sürümleri düzenli olarak yayınlanmakta ve bazı sürümler kullanımdan kaldırılmaktadır. Yeni sürümler, desteği sonlandırılan özellikler ve kullanımdan kaldırılan özelliklerle ilgili güncellemeler aşağıdaki kanallarda yayınlanır:

En son API haberlerinden haberdar olmak için bu kanallardan en az birine abone olmanız önerilir.