Halaman ini diterjemahkan oleh Cloud Translation API.

Bermigrasi ke Versi Baru

Versi baru Campaign Manager 360 API dirilis secara berkala. Karena versi baru dirilis, versi yang lebih lama tidak digunakan lagi dan pada akhirnya akan dihentikan. Jika suatu 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 menjelaskan 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 mempertahankan aplikasi yang Anda curigai mungkin menggunakan versi Campaign Manager 360 API yang sudah tidak digunakan lagi, Anda harus terlebih dahulu memverifikasi versi spesifik yang Anda gunakan. Dalam sebagian besar kasus, Anda akan mengakses API melalui salah satu library klien khusus bahasa atau integrasi resmi. Petunjuk untuk menemukan versi API yang digunakan oleh library dan integrasi klien ini dapat ditemukan di bawah:

Editor baru Apps Script

Informasi versi untuk Apps Script ditampilkan dalam dialog layanan lanjutan:

Dari editor Apps Script, klik Tambahkan layanan .
Cari Campaign Manager 360 API dalam daftar layanan yang tersedia.
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:

Dari editor Apps Script, buka Resource > Layanan Google lanjutan.
Cari Campaign Manager 360 API dalam daftar layanan yang tersedia.
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:

Disertakan dalam nama paket nuget dan namespace layanan.
```
Google.Apis.Dfareporting.v3_4
```
Diekspos melalui properti publik DfareportingService.
```
Console.WriteLine(DfareportingService.Version);
```

Java

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

Ditentukan dalam artefakId maven.

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

Disertakan dalam nama file JAR.

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

Diekspos 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 tidak memiliki versi. Versi API yang akan digunakan ditetapkan sebagai argumen untuk pembuat penemuan:

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

Ruby

Library Klien Google API untuk Ruby versi < 0.9 tidak menggunakan versi. Versi API yang akan digunakan ditetapkan 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 versi Ruby >= 0.9, versi akan ditampilkan di namespace layanan:

Google.Apis.DfareportingV3_4

Catat versi yang Anda gunakan, karena Anda akan memerlukan informasi ini di lain waktu.

Langkah 2: Tentukan status versi Anda

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

Jika tidak ada tanggal yang tercantum di kolom Tanggal Penghentian dan Tanggal Berakhir, artinya Anda menggunakan versi yang didukung sepenuhnya.
Jika tanggal tercantum, versi yang Anda gunakan saat ini tidak digunakan lagi dan akan dihentikan pada tanggal yang ditentukan.
Jika versi Anda tidak tercantum, berarti layanan sudah dihentikan dan tidak lagi didukung.

Jika Anda masuk ke #2 atau #3 di atas, Anda harus bermigrasi ke versi yang lebih baru untuk menghindari gangguan layanan. Sebaiknya Anda bermigrasi ke versi terbaru, yang tercantum di bagian atas tabel jadwal penghentian (tidak termasuk rilis beta). 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 versi terbaru dari library klien pilihan Anda. Perhatikan bahwa meskipun beberapa library klien hanya dapat menyediakan satu build yang berfungsi dengan versi API apa pun, yang lainnya akan memiliki build terpisah untuk setiap versi. Daftar di bawah ini memberikan informasi upgrade umum untuk library dan integrasi 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:

Dari editor Apps Script, klik Tambahkan layanan .
Cari Campaign Manager 360 API dalam daftar layanan yang tersedia.
Ubah versi Campaign Manager 360 yang digunakan melalui dropdown versi.
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:

Dari editor Apps Script, buka Resource > Layanan Google lanjutan.
Cari Campaign Manager 360 API dalam daftar layanan yang tersedia.
Ubah versi Campaign Manager 360 yang digunakan melalui dropdown versi.
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 mendukung semua versi Campaign Manager 360 API. Cukup perbarui string versi yang diteruskan sebagai argumen ke builder discovery:

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. 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 berusaha membuat rilis baru kami kompatibel dengan versi sebelumnya, yang berarti dengan melakukan migrasi antar-versi API tidak akan menyebabkan perubahan pada kode Anda. Jika hal ini tidak dapat dilakukan, kami akan mengumumkan perubahan yang memerlukan tindakan dari developer (juga dikenal sebagai perubahan yang dapat menyebabkan gangguan) di catatan rilis kami.

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

Fitur baru - Fungsi yang baru ditambahkan.
Sunset - Fungsi yang telah dihapus dari API. Jika tersedia, fungsi pengganti akan dibahas di bagian ini.
Masalah umum - Perubahan yang tidak bersifat 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 pada bagian Matahari Terbenam atau Masalah umum, Anda mungkin perlu mengambil tindakan. Anda harus menelusuri kode untuk mengetahui apakah ada fungsi yang dihapus atau diubah yang digunakan oleh aplikasi. Jika demikian, Anda harus membuat pembaruan pada kode untuk mengatasi perubahan ini

Mendapatkan informasi terbaru

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

Sebaiknya Anda subscribe ke satu atau beberapa channel ini untuk mendapatkan kabar terbaru terkait API.