Looker API 4.0 Tersedia Secara Umum

Dengan senang hati kami mengumumkan bahwa Looker API 4.0 tersedia secara umum di Looker 22.4. API 4.0 (API 4.0 GA) yang tersedia secara umum memiliki beberapa perubahan yang dapat menyebabkan gangguan dan perubahan tambahan, serta mempromosikan beberapa endpoint dari Beta ke Stabil. Lihat referensi API kami untuk mengetahui spesifikasi API 4.0 secara mendetail. Kami memperbarui SDK yang didukung Looker dan didukung Komunitas untuk mendukung endpoint GA Looker API 4.0. Untuk informasi selengkapnya, lihat Kebijakan dukungan API dan SDK serta Pembuatan Versi API. Bagian lainnya dalam artikel ini menguraikan perubahan, mitigasi, dan fitur yang dapat menyebabkan gangguan yang dapat Anda harapkan saat bermigrasi ke API 4.0 GA.

Siapa yang harus membaca ini?

Dokumen ini ditujukan untuk Anda jika Anda menggunakan Looker API melalui SDK yang didukung Looker, SDK yang didukung Komunitas, atau API itu sendiri. Baca bagian berikut yang dipetakan ke versi Looker API yang saat ini Anda gunakan.

Pengguna Pra-GA API 4.0

Jika Anda menggunakan API 4.0, baca bagian ini. Panduan ini mencakup perubahan yang dapat menyebabkan gangguan dan mitigasi yang tersedia saat Anda bermigrasi ke API 4.0 GA.

API 4.0 GA menyertakan perubahan semua kolom ID entitas dari jenis integer numerik menjadi jenis string. Misalnya, GET /groups/{group_id} endpoint menampilkan id sebagai jenis string, bukan jenis int64.

Baca tabel berikut untuk mengetahui dampak dan mitigasi khusus untuk penggunaan endpoint API 4.0 Anda:

Penggunaan Potensi Dampak1 Pencegahan
Aplikasi seluler Looker Penginstalan aplikasi seluler Looker yang sudah tidak berlaku akan berhenti berfungsi Meminta pengguna mengupdate aplikasi seluler Looker ke versi terbaru
SDK 2 yang Didukung Looker
TypeScript SDK (API 4.0) Tidak ada dampak Tidak perlu tindakan apa pun
Python SDK (4.0 API) Tidak ada dampak Tidak perlu tindakan apa pun
SDK Ruby (API 4.0) Tidak ada dampak Tidak perlu tindakan apa pun
SDK2 yang Didukung Komunitas
SDK Swift Pengecualian runtime Mengupdate SDK ke v22.0+; lalu mengatasi error jenis yang dihasilkan, jika ada
SDK Kotlin Tidak ada dampak Tidak perlu tindakan apa pun
SDK Looker Tidak ada dampak Tidak perlu tindakan apa pun
SDK C# Tidak ada dampak Tidak perlu tindakan apa pun
SDK Go Pengecualian runtime Mengupdate SDK ke v22.0+; lalu mengatasi error jenis yang dihasilkan, jika ada
Lainnya
Menggunakan 4.0 API tanpa SDK (atau dengan library yang disediakan secara eksternal) Kemungkinan error runtime, bergantung pada sensitivitas jenis bahasa Meninjau kode untuk dependensi pada jenis kolom ID dan menambahkan dukungan untuk kolom ID jenis string. Tinjau juga panduan tambahan ini.

1: Dengan asumsi pola penggunaan umum yang mungkin mencakup penggunaan kolom ID Looker, tetapi bukan pola penggunaan yang tidak biasa, seperti menerapkan operasi numerik ke ID.

2: Dukungan SDK & Looker API. Library yang didukung komunitas tidak didukung secara resmi oleh Looker.

Pengguna API 3.1

Jika Anda menggunakan API 3.1, baca bagian ini. Panduan ini mencakup fitur dan perubahan tambahan yang disediakan oleh API 4.0 untuk Anda. Perlu diingat, semua SDK kami yang didukung Looker dan didukung Komunitas terutama mendukung API 4.0. Lihat kebijakan dukungan SDK dan API untuk mengetahui informasi selengkapnya.

Fitur GA API 4.0 Tambahan

Untuk memudahkan, kami mencantumkan perubahan aditif API 4.0 yang paling penting dan berguna untuk Anda:

Perubahan Penghentian Penggunaan GA API 4.0

GA API 4.0 menggantikan beberapa endpoint API 3.1 yang tidak digunakan lagi dengan fitur yang ditingkatkan. Kami mencantumkan endpoint yang terpengaruh di bawah:

Pengguna API 3.0

API 3.0 tidak digunakan lagi, dan sebaiknya Anda bermigrasi ke API 4.0.

  • Hanya API 4.0 yang mendukung semua SDK yang didukung Looker dan SDK yang didukung Komunitas untuk memudahkan pengembangan Anda. Lihat repositori SDK kami.
  • API 4.0 memperkenalkan beberapa fitur dan peningkatan baru seperti yang tercantum di atas.

Akhir kata

Anda dapat menantikan fitur baru dan perubahan tambahan yang akan ditambahkan pada API 4.0, dan Anda dapat selalu menemukan perubahan terbaru dalam referensi API kami. Untuk informasi selengkapnya, lihat Kebijakan dukungan API dan SDK serta Pembuatan Versi API. Kami tahu perubahan yang dapat menyebabkan gangguan itu tidak ideal. Kecuali jika ada masalah ekstrem, kami tidak akan membuat perubahan yang dapat menyebabkan gangguan pada API 4.0 yang tersedia secara umum. Kami harap Looker API 4.0 kami yang tersedia secara umum dapat membantu Anda melakukan pengembangan dengan lebih produktif dan mudah di platform Looker.