Bu sayfa, Cloud Translation API ile çevrilmiştir.

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ümler kullanımdan kaldırılır ve zamanla kullanımdan kaldırılır. Bir sürüm kullanımdan kaldırıldığında söz konusu sürüme yönelik tüm istekler hata döndürmeye başlar.

Kullandığınız API'nin bir sürümü kullanımdan kaldırılırsa planlanan gün batımı tarihinden önce daha yeni bir sürüme geçmeniz gerekir. Bu rehberde, kullandığınız API sürümünün kullanımdan kaldırılıp kaldırılmadığıyla ilgili ayrıntılı bilgi ve önerilen taşıma adımları açıklanmaktadır.

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

Campaign Manager 360 API'nin kullanımdan kaldırılmış bir sürümünü kullanıyor olabileceğini düşündüğünüz bir uygulamayı kullanıyorsanız öncelikle hangi sürümü kullanmakta olduğunuzu doğrulamanız gerekir. Çoğu durumda API'ye dile özgü istemci kitaplıklarımızdan biri veya resmi entegrasyon aracılığıyla 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ı yeni düzenleyici

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

Apps Komut Dosyası düzenleyicisinde Hizmet ekle'yi tıklayın.
Kullanılabilir hizmetler listesinde Campaign Manager 360 API'yi bulun.
Sürüm açılır listesinde seçilen değer, şu anda kullanılmakta olan Campaign Manager 360 API sürümüdür.

Apps Komut Dosyası eski düzenleyicisi

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

Apps Komut Dosyası düzenleyicisinde Kaynaklar > Gelişmiş Google hizmetleri'ne gidin.
Kullanılabilir hizmetler listesinde Campaign Manager 360 API'yi bulun.
Sürüm açılır listesinde seçilen değer, şu anda kullanılmakta olan Campaign Manager 360 API sürümüdür.

C#

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

nuget paket adı ve hizmet ad alanına dahil edilir.
```
Google.Apis.Dfareporting.v3_4
```
DfareportingService herkese açık mülkü üzerinden gösteriliyor.
```
Console.WriteLine(DfareportingService.Version);
```

Java

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

Maven artifactId'de belirtildi.

<dependency>
  <groupId>com.google.apis</groupId>
  <artifactId>google-api-services-dfareporting</artifactId>
  <version>v3.4-rev1-1.21.0</version>
</dependency>

JAR dosya adına dahildir.

google-api-services-dfareporting-v3.4-rev1-1.21.0.jar

Dfareporting herkese açık mülkü üzerinden gösteriliyor.
```
System.out.println(Dfareporting.DEFAULT_SERVICE_PATH);
```

PHP

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

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

Python

Python için Google API İstemci Kitaplığı'nın sürümü oluşturulmadı. 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 veya daha düşük sürümdeki Google API İstemci Kitaplığı için sürüm oluşturulmaz. Kullanılacak API sürümü, hizmet oluşturucunun 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
    }
)

Google Workspace İstemci Kitaplığı'nın >= 0.9 ve sonraki sürümleri için sürüm hizmet ad alanında kullanıma sunulur:

Google.Apis.DfareportingV3_4

Bu bilgiye daha sonra ihtiyaç duyacağınız için kullandığınız sürümü not edin.

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

Kullanımdan Kaldırma Planı şu anda desteklenen her sürümün durumunu listeler. Bu listede sürümünüzü bulun ve durumunu aşağıdaki gibi belirleyin:

Kullanımdan Kaldırma Tarihi ve Sonlandırma Tarihi sütunlarında listelenen bir tarih yoksa tam olarak desteklenen bir sürüm kullanıyorsunuz demektir.
Tarihler listeleniyorsa, kullandığınız sürüm şu anda kullanımdan kaldırılmıştır ve belirtilen tarihte kullanımdan kaldırılacaktır.
Sürümünüz listede yer almıyorsa, zaten kullanımdan kaldırılmıştır ve artık desteklenmemektedir.

Yukarıdaki 2 veya 3 numaralı maddede yer alıyorsanız hizmet kesintisi yaşamamak için daha yeni bir sürüme geçmeniz gerekir. Kullanımdan kaldırma planı tablosunun üst kısmında listelenen en yeni sürüme (beta sürümleri hariç) geçmeniz önerilir. Bu sayede, yükseltmeler arasında maksimum süre verilir.

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

Taşıma yapmanız gerektiğine karar verdiyseniz bir sonraki adım, entegrasyonunuzu güncellemek veya tercih ettiğiniz istemci kitaplığının güncellenmiş bir derlemesini almaktır. Bazı istemci kitaplıklarının herhangi bir API sürümüyle çalışan tek bir derleme sağlayabildiğini, bazılarının ise her sürüm için ayrı derlemeleri olacağını unutmayın. Aşağıdaki listede, en yaygın kullanılan istemci kitaplıkları ve entegrasyonlar için genel yükseltme bilgileri verilmektedir.

Apps Komut Dosyası yeni düzenleyici

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

Apps Komut Dosyası düzenleyicisinde Hizmet ekle'yi tıklayın.
Kullanılabilir hizmetler listesinde Campaign Manager 360 API'yi bulun.
Kullanımdaki Campaign Manager 360 API sürümünü, sürüm açılır menüsünden değiştirin.
Yaptığınız değişiklikleri kaydetmek için Ekle'yi tıklayın.

Apps Komut Dosyası eski düzenleyicisi

Apps Komut Dosyası düzenleyicisinde Kaynaklar > Gelişmiş Google hizmetleri'ne gidin.
Kullanılabilir hizmetler listesinde Campaign Manager 360 API'yi bulun.
Kullanımdaki Campaign Manager 360 API sürümünü, sürüm açılır menüsünden değiştirin.
Yaptığınız değişiklikleri 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ı yükleme talimatları veya alternatif indirme seçenekleri için istemci kitaplığı dokümanlarına bakın.

Java

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

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

PHP

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

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

Python

Python için Google API İstemci Kitaplığı'nın her derlemesi Campaign Manager 360 API'nin tüm sürümlerini destekler. Keşif 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ı yükleme talimatları veya alternatif indirme seçenekleri için istemci kitaplığı dokümanlarına bakın.

Ruby

Wild v0.8 ve önceki sürümler için Google API İstemci Kitaplığı, Campaign Manager 360 API'nin tüm sürümlerini destekler. Hizmet oluşturucuya bağımsız değişken olarak iletilmekte olan 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
    }
)

Ruge Gems aracılığıyla dağıtılan her bir Campaign Manager 360 API sürümü için Google sürüm 0.9 ve üzeri için Google API İstemci Kitaplığı ayrı derlemeler sağlar. Ayrıntılı yükleme talimatları veya alternatif indirme seçenekleri için istemci kitaplığı dokümanlarına bakın.

4. Adım: Sürüm farklılıklarını giderin

Yeni sürümlerimizi geriye dönük olarak uyumlu hale getirmeye çalışıyoruz. Bu nedenle, API sürümleri arasında geçiş yapmak için kodda değişiklik yapmanız gerekmez. Bu mümkün olmadığında geliştiricilerden işlem yapmalarını gerektiren değişiklikleri (son değişiklik olarak da bilinir) sürüm notlarımızda duyurduk.

Bu noktada, önceki sürümden (bir önceki bölümde not ettiğiniz) son sürümden başlayarak ve yükseltme yaptığınız sürüme kadar devam eden sürüm notlarımızı incelemeniz gerekir. Sürüm notlarının bölümleri şu şekilde yorumlanmalıdır:

Yeni özellikler - Yeni eklenen işlevler.
Gün Batımları: API'den kaldırılan işlevlerdir. Değişim işlevleri mevcut olduğunda bu bölümde ele alınacaktır.
Bilinen sorunlar: Ekleme veya kaldırma olmayan değişiklikler. Örneğin, bu bölüm yeniden adlandırılan alanları veya yöntemleri ya da değişen doğrulama mantığını kapsayabilir.

Yeni özellikler'deki işlevler için kod değişikliği gerekmez ve şu an için yoksayılabilir. Eklediğimiz yeni özellikleri denemek için bu bölüme daha sonra dönebilirsiniz.

Diğer yandan, Gün batımı veya Bilinen sorunlar bölümlerinde değişiklikler bulursanız işlem yapmanız gerekebilir. Kullanımdan kaldırılmış veya değiştirilmiş işlevlerden herhangi birinin uygulamanız tarafından kullanılıp kullanılmadığını belirlemek için kodunuzda arama yapmanız gerekir. Böyle bir durum söz konusuysa bu değişiklikleri ele almak için kodunuzda güncellemeler yapmanız gerekir

Haberdar olun

Daha önce de belirtildiği gibi, Campaign Manager 360 API sürümleri ve kullanımdan kaldırma işlemleri düzenli olarak gerçekleştirilir. Yeni sürümler, kullanımdan kaldırmalar ve sonlandırmalarla ilgili güncellemeler şu kanallarda yayınlanır:

En son API haberlerinden haberdar olmak için bu kanallardan birine veya daha fazlasına abone olmanız önerilir.