Bermigrasi ke Versi Baru

Versi baru Campaign Manager 360 API dirilis secara rutin. Saat versi baru dirilis, versi sebelumnya tidak digunakan lagi dan pada akhirnya dihentikan. Saat versi dihentikan, semua permintaan terhadap versi tersebut mulai menampilkan error.

Jika versi yang Anda gunakan sudah tidak digunakan lagi, Anda harus melakukan upgrade sesegera mungkin untuk menghindari gangguan layanan.

Langkah 1: Tentukan versi yang Anda gunakan

Anda dapat menentukan versi API yang Anda gunakan dengan mengikuti petunjuk berikut. Dalam sebagian besar kasus, Anda akan mengakses API menggunakan salah satu library klien khusus bahasa atau integrasi resmi kami.

Editor baru Apps Script

Informasi versi untuk Apps Script ditampilkan dalam dialog layanan tingkat lanjut:

  1. Dari editor Apps Script, klik Tambahkan layanan .
  2. Temukan Campaign Manager 360 API dalam daftar layanan yang tersedia.
  3. Nilai yang dipilih di drop-down versi adalah versi Campaign Manager 360 API yang digunakan.

Editor lama Apps Script

Informasi versi untuk Apps Script ditampilkan dalam dialog layanan tingkat lanjut:

  1. Dari editor Apps Script, buka Resources > Advanced Google services.
  2. Temukan Campaign Manager 360 API dalam daftar layanan yang tersedia.
  3. Nilai yang dipilih di drop-down versi adalah versi Campaign Manager 360 API yang digunakan.

C#

Informasi versi untuk Library Klien Google API untuk .NET ditampilkan di tempat berikut:

  1. Disertakan dalam nama paket NuGet dan namespace layanan. 
    Google.Apis.Dfareporting.v3_4
  2. Diekspos menggunakan properti publik DfareportingService. 
    Console.WriteLine(DfareportingService.Version);

Java

Informasi versi untuk Library Klien Google API untuk Java ditampilkan di tempat berikut:

  1. Ditentukan dalam artifactId Maven. 
    <dependency> <groupId>com.google.apis</groupId>
<artifactId>google-api-services-dfareporting</artifactId>
<version>v3.4-rev1-1.21.0</version>
</dependency>
  2. Disertakan dalam nama file JAR. 
    google-api-services-dfareporting-v3.4-rev1-1.21.0.jar
  3. Diekspos menggunakan properti publik Dfareporting. 
    System.out.println(Dfareporting.DEFAULT_SERVICE_PATH);

PHP

Informasi versi untuk Library Klien Google API untuk PHP ditampilkan menggunakan properti publik Google_Service_Dfareporting: 

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

Python

Library Klien Google API untuk Python (v1/v2) tidak memiliki versi. Versi API yang akan digunakan ditentukan sebagai argumen untuk pembuat penemuan: 

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

Ruby

Library Klien Google API untuk Ruby versi < 0.9 tidak diberi versi. Versi API yang akan digunakan ditentukan sebagai argumen untuk konstruktor layanan: 

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

Untuk Library Klien Google API untuk Ruby versi >= 0.9, versi ditampilkan di namespace layanan: 

Google.Apis.DfareportingV3_4

Langkah 2: Tentukan status versi Anda

Periksa jadwal penghentian penggunaan untuk menentukan status versi Anda. Jika versi Anda tidak tercantum, berarti versi tersebut telah dihentikan dan tidak lagi didukung.

Jika versi Anda tercantum, periksa kolom Tanggal Penghentian dan Tanggal Penghentian Layanan:

  • Jika tidak ada tanggal, versi Anda didukung sepenuhnya.
  • Jika ada tanggal, versi Anda tidak digunakan lagi dan akan dihentikan pada tanggal yang ditentukan.

Jika versi Anda tidak digunakan lagi atau telah dihentikan, Anda harus bermigrasi ke versi yang lebih baru untuk menghindari gangguan layanan. Sebaiknya lakukan migrasi ke versi terbaru yang ditampilkan dalam jadwal (tidak termasuk rilis beta) untuk memaksimalkan waktu antara upgrade.

Langkah 3: Upgrade versi

Untuk bermigrasi ke versi API yang lebih baru, Anda harus mengupdate integrasi atau mendapatkan build terbaru dari library klien pilihan Anda. Perhatikan bahwa meskipun beberapa library klien dapat menyediakan satu build yang berfungsi dengan versi API apa pun, library lainnya akan memiliki build terpisah untuk setiap versi. Daftar berikut memberikan informasi upgrade umum untuk integrasi dan library klien yang paling banyak digunakan.

Editor baru Apps Script

Google Apps Script mendukung semua versi Campaign Manager 360 API dan memungkinkan Anda memilih versi yang akan digunakan berdasarkan per skrip. Untuk mengubah versi yang digunakan oleh skrip tertentu:

  1. Dari editor Apps Script, klik Tambahkan layanan .
  2. Temukan Campaign Manager 360 API dalam daftar layanan yang tersedia.
  3. Ubah versi Campaign Manager 360 API menggunakan drop-down versi.
  4. Klik Tambahkan untuk menyimpan perubahan.

Editor lama Apps Script

Google Apps Script mendukung semua versi Campaign Manager 360 API dan memungkinkan Anda memilih versi yang akan digunakan berdasarkan per skrip. Untuk mengubah versi yang digunakan oleh skrip tertentu:

  1. Dari editor Apps Script, buka Resources > Advanced Google services.
  2. Temukan Campaign Manager 360 API dalam daftar layanan yang tersedia.
  3. Ubah versi Campaign Manager 360 API menggunakan drop-down versi.
  4. Klik OK untuk menyimpan perubahan.

C#

Library Klien Google API untuk .NET menyediakan build terpisah untuk setiap versi Campaign Manager 360 API, yang didistribusikan melalui NuGet. Update ke versi library klien yang sesuai dengan versi API yang ingin Anda gunakan.

Untuk petunjuk penginstalan mendetail atau opsi download alternatif, lihat dokumentasi library klien.

Java

Google API Client Library untuk Java menyediakan build terpisah untuk setiap versi Campaign Manager 360 API, yang didistribusikan melalui Maven. Update ke versi library klien yang sesuai dengan versi API yang ingin Anda gunakan.

Untuk petunjuk penginstalan mendetail atau opsi download alternatif, lihat dokumentasi library klien.

PHP

Google API Client Library for PHP menyediakan build terpisah untuk setiap versi Campaign Manager 360 API, yang didistribusikan melalui Packagist. Update ke versi library klien yang sesuai dengan versi API yang ingin Anda gunakan.

Untuk petunjuk penginstalan mendetail atau opsi download alternatif, lihat dokumentasi library klien.

Python

Setiap build Library Klien Google API untuk Python (v1/v2) mendukung semua versi Campaign Manager 360 API. Untuk bermigrasi ke Campaign Manager 360 API versi baru, perbarui string versi yang diteruskan sebagai argumen ke builder penemuan: 

discovery.build('dfareporting', 'v3.4', http=http)
 Untuk petunjuk penginstalan mendetail atau opsi download alternatif, lihat dokumentasi library klien.

Ruby

Library Klien Google API untuk Ruby v0.8 dan yang lebih rendah mendukung semua versi Campaign Manager 360 API. Untuk bermigrasi ke Campaign Manager 360 API versi baru, perbarui string versi yang diteruskan sebagai argumen ke konstruktor layanan: 

service = Google::APIClient::Service.new("dfareporting", "v3.4",
    {
      :application_name => "My application",
      :application_version => '1.0.0',
      :authorization => authorization
    }
)
 Library Klien Google API untuk Ruby v0.9+ menyediakan build terpisah untuk setiap versi Campaign Manager 360 API, yang didistribusikan melalui RubyGems. Update ke versi library klien yang sesuai dengan versi API yang ingin Anda gunakan. Untuk petunjuk penginstalan mendetail atau opsi download alternatif, lihat dokumentasi library klien.

REST

Jika Anda memanggil API secara langsung menggunakan HTTPS, perbarui endpoint untuk permintaan Anda agar menggunakan nomor versi API baru.

Misalnya, saat bermigrasi dari v4 ke v5, Anda akan mengubah URL dasar dari: 

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

Langkah 4: Perbedaan versi alamat

Versi API baru dirancang agar kompatibel mundur jika memungkinkan. Namun, beberapa update dapat mencakup perubahan yang merusak dan mengharuskan Anda mengubah kode. Perubahan ini dijelaskan dalam catatan rilis.

Saat melakukan migrasi, tinjau catatan rilis untuk setiap versi antara versi saat ini dan versi yang akan Anda upgrade. Berikan perhatian khusus pada bagian berikut:

  • Fitur baru: Fungsi yang baru ditambahkan. Perubahan ini tidak memerlukan perubahan kode untuk migrasi.
  • Penghentian: Fungsi dihapus dari API. Fungsi pengganti dicatat jika tersedia.
  • Masalah umum: Modifikasi pada fungsi yang ada, seperti kolom atau metode yang diganti namanya, atau logika validasi yang diubah.

Jika aplikasi Anda menggunakan fungsi yang tercantum di bagian Penghentian atau Masalah umum, Anda harus mengupdate kode untuk mengatasi perubahan ini.

Ikuti perkembangan berita

Pantau blog developer Google Ads secara rutin untuk menjadi yang pertama mengetahui rilis, penghentian penggunaan, dan penghentian API.