Bermigrasi ke Versi Baru

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

Jika versi yang Anda gunakan dihentikan, 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 petunjuk berikut. Pada umumnya, Anda akan mengakses API menggunakan salah satu library klien khusus bahasa kami atau integrasi resmi.

Editor baru Apps Script

Informasi versi untuk Apps Script ditampilkan dalam dialog layanan lanjutan:

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

Editor lama Apps Script

Informasi versi untuk Apps Script ditampilkan dalam dialog layanan lanjutan:

  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 menu 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.v5
  2. Ditampilkan 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 Maven artifactId. 
    <dependency> <groupId>com.google.apis</groupId>
<artifactId>google-api-services-dfareporting</artifactId>
<version>v5-rev20260213-2.0.0</version>
</dependency>
  2. Disertakan dalam nama file JAR. 
    google-api-services-dfareporting-v5-rev20260213-2.0.0.jar
  3. Ditampilkan 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', 'v5', http=http)

Ruby

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

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

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

Google.Apis.DfareportingV5

Langkah 2: Tentukan status versi Anda

Periksa jadwal penghentian untuk menentukan status versi Anda. Jika versi Anda tidak tercantum, 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 dihentikan dan akan dihentikan layanannya pada tanggal yang ditentukan.

Jika versi Anda dihentikan atau telah dihentikan layanannya, Anda harus bermigrasi ke versi yang lebih baru untuk menghindari gangguan layanan. Sebaiknya migrasikan 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 klien 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 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 menu 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 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 menu 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

Library Klien Google API 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

Library Klien Google API untuk 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 versi baru Campaign Manager 360 API, update string versi yang diteruskan sebagai argumen ke pembuat penemuan: 

discovery.build('dfareporting', 'v5', 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 versi baru Campaign Manager 360 API, update string versi yang diteruskan sebagai argumen ke konstruktor layanan: 

service = Google::APIClient::Service.new("dfareporting", "v5",
    {
      :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, update 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/...
 menjadi: 
https://dfareporting.googleapis.com/dfareporting/v5/...

Langkah 4: Atasi perbedaan versi

Versi API baru dirancang agar kompatibel dengan versi sebelumnya jika memungkinkan. Namun, beberapa update mungkin menyertakan perubahan yang dapat menyebabkan gangguan dan mengharuskan Anda mengubah kode. Perubahan ini dijelaskan dalam catatan rilis.

Saat bermigrasi, tinjau catatan rilis untuk setiap versi antara versi Anda saat ini dan versi yang Anda upgrade. Perhatikan bagian berikut:

  • Fitur baru: Fungsi yang baru ditambahkan. Fitur ini tidak memerlukan perubahan kode untuk migrasi.
  • Penghentian: Fungsi yang dihapus dari API. Fungsi pengganti akan 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 agar Anda menjadi orang pertama yang mengetahui rilis, penghentian, dan penghentian layanan API.