Bermigrasi ke Versi Baru

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

Jika versi API yang Anda gunakan tidak digunakan lagi, Anda harus bermigrasi ke versi yang lebih baru sebelum tanggal penghentian yang dijadwalkan. Panduan ini memberikan detail tentang cara menentukan apakah versi API yang Anda gunakan tidak digunakan lagi dan memberikan langkah-langkah migrasi yang direkomendasikan.

Langkah 1: Tentukan versi yang Anda gunakan

Jika Anda mengelola aplikasi yang Anda curigai mungkin menggunakan versi Campaign Manager 360 API yang tidak digunakan lagi, Anda harus memverifikasi terlebih dahulu versi tertentu yang Anda gunakan. Pada umumnya, Anda akan mengakses API melalui salah satu library klien khusus bahasa atau integrasi resmi kami. Petunjuk untuk menemukan versi API yang digunakan oleh library klien dan integrasi ini dapat ditemukan di bawah:

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 dropdown versi adalah versi Campaign Manager 360 API yang saat ini digunakan.

Editor lama Apps Script

Informasi versi untuk Apps Script ditampilkan dalam dialog layanan lanjutan:

1. Dari editor Apps Script, buka Referensi > Layanan Google lanjutan.
2. Temukan Campaign Manager 360 API dalam daftar layanan yang tersedia.
3. Nilai yang dipilih di dropdown versi adalah versi Campaign Manager 360 API yang saat ini 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. Ditampilkan melalui 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. Ditampilkan melalui properti publik Dfareporting.

   System.out.println(Dfareporting.DEFAULT_SERVICE_PATH);

PHP

Informasi versi untuk Library Klien Google API untuk PHP ditampilkan melalui 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 memiliki 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

Catat versi yang Anda gunakan, karena Anda akan memerlukan informasi ini nanti.

Langkah 2: Tentukan status versi Anda

Jadwal Penghentian mencantumkan status setiap versi yang saat ini didukung. Temukan versi Anda dalam daftar ini dan tentukan statusnya sebagai berikut:

1. Jika tidak ada tanggal yang tercantum di kolom Tanggal Penghentian dan Tanggal Penghentian Layanan, berarti Anda menggunakan versi yang sepenuhnya didukung.
2. Jika tanggal tercantum, versi yang Anda gunakan saat ini tidak digunakan lagi dan akan dihentikan pada tanggal yang ditentukan.
3. Jika versi Anda tidak tercantum, versi tersebut telah dihentikan dan tidak lagi didukung.

Jika Anda termasuk dalam #2 atau #3 di atas, Anda harus bermigrasi ke versi yang lebih baru untuk menghindari gangguan layanan. Sebaiknya migrasikan ke versi terbaru, yang tercantum di bagian atas tabel jadwal penghentian (tidak termasuk rilis beta). Hal ini akan memberi Anda jumlah waktu maksimum di antara upgrade.

Langkah 3: Upgrade versi

Jika Anda telah memutuskan bahwa Anda perlu melakukan migrasi, langkah berikutnya adalah memperbarui integrasi atau mendapatkan build terbaru dari library klien pilihan Anda. Perhatikan bahwa meskipun beberapa library klien mungkin hanya menyediakan satu build yang berfungsi dengan versi API apa pun, library lainnya akan memiliki build terpisah untuk setiap versi. Daftar di bawah ini 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 yang digunakan melalui dropdown 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 Referensi > Layanan Google lanjutan.
2. Temukan Campaign Manager 360 API dalam daftar layanan yang tersedia.
3. Ubah versi Campaign Manager 360 API yang digunakan melalui dropdown 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.

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.

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.

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. Cukup 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 lama mendukung semua versi Campaign Manager 360 API. Cukup 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. Untuk petunjuk penginstalan mendetail atau opsi download alternatif, lihat dokumentasi library klien.

Langkah 4: Atasi perbedaan versi

Kami berupaya membuat rilis baru kompatibel dengan versi sebelumnya, yang berarti migrasi antar-versi API tidak akan memerlukan perubahan pada kode Anda. Jika tidak memungkinkan, kami akan mengumumkan perubahan yang memerlukan tindakan dari developer (juga dikenal sebagai perubahan yang dapat menyebabkan gangguan) dalam catatan rilis kami.

Pada tahap ini, Anda harus meninjau catatan rilis kami, dimulai dengan versi setelah versi yang Anda mulai (yang Anda catat di bagian sebelumnya) dan berlanjut hingga dan termasuk versi yang akan Anda upgrade. Bagian catatan rilis harus ditafsirkan sebagai berikut:

• Fitur baru - Fungsi yang baru ditambahkan.
• Penghentian - Fungsi yang telah dihapus dari API. Jika tersedia, fungsi pengganti akan dibahas di bagian ini.
• Masalah umum - Perubahan yang bukan merupakan penambahan atau penghapusan. Misalnya, bagian ini dapat mencakup kolom atau metode yang telah diganti namanya, atau logika validasi yang telah berubah.

Fungsi di Fitur baru tidak akan memerlukan perubahan kode dan dapat diabaikan untuk saat ini. Jangan ragu untuk kembali ke bagian ini nanti jika Anda ingin bereksperimen dengan sesuatu yang telah kami tambahkan.

Di sisi lain, jika Anda menemukan perubahan di bagian Penghentian atau Masalah umum, Anda mungkin perlu mengambil tindakan. Anda harus menelusuri kode untuk menentukan apakah ada fungsi yang dihapus atau diubah yang digunakan oleh aplikasi Anda. Jika demikian, Anda harus melakukan update pada kode untuk mengatasi perubahan ini

Mendapatkan informasi terbaru

Seperti yang disebutkan sebelumnya, rilis dan penghentian Campaign Manager 360 API terjadi secara rutin. Info terbaru tentang rilis baru, penghentian penggunaan, dan penghentian layanan diposting ke saluran berikut:

• Blog Developer Google Ads (berlangganan untuk mendapatkan notifikasi email)
• Forum Campaign Manager 360 API

Sebaiknya Anda berlangganan satu atau beberapa saluran ini untuk terus mendapatkan info terbaru tentang API.