Dengan senang hati kami umumkan bahwa Looker API 4.0 tersedia secara umum di Looker 22.4. API 4.0 yang tersedia secara umum (API 4.0 GA) 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 telah memperbarui SDK yang didukung Looker dan SDK yang didukung Komunitas untuk mendukung endpoint Looker API 4.0 GA. Untuk mengetahui informasi selengkapnya, lihat Kebijakan dukungan API dan SDK serta Pembuatan Versi API. Bagian selanjutnya dari artikel ini menguraikan perubahan yang dapat menyebabkan gangguan, mitigasi, dan fitur yang dapat Anda nantikan saat bermigrasi ke API 4.0 GA.
Siapa yang harus membaca artikel ini?
Dokumen ini ditujukan untuk Anda jika 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 Anda gunakan.
Pengguna API 4.0 Pra-GA
Jika Anda menggunakan API 4.0, baca bagian ini. Bagian ini membahas perubahan yang dapat menyebabkan gangguan dan mitigasi yang tersedia saat Anda bermigrasi ke API 4.0 GA.
API 4.0 GA mencakup perubahan semua kolom ID entity dari jenis integer numerik ke 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 | Instalasi aplikasi seluler Looker yang sudah tidak berlaku berhenti berfungsi | Minta pengguna mengupdate ke versi terbaru aplikasi seluler Looker |
| SDK2 yang Didukung Looker | ||
| SDK TypeScript (API 4.0) | Tidak ada dampak | Tidak diperlukan tindakan |
| SDK Python (API 4.0) | Tidak ada dampak | Tidak diperlukan tindakan |
| SDK Ruby (API 4.0) | Tidak ada dampak | Tidak diperlukan tindakan |
| SDK 2 yang Didukung Komunitas | ||
| SDK Swift | Pengecualian runtime | Update SDK ke v22.0+; lalu selesaikan error jenis yang dihasilkan, jika ada |
| SDK Kotlin | Tidak ada dampak | Tidak diperlukan tindakan |
| SDK LookR | Tidak ada dampak | Tidak diperlukan tindakan |
| SDK C# | Tidak ada dampak | Tidak diperlukan tindakan |
| SDK Go | Pengecualian runtime | Update SDK ke v22.0+; lalu selesaikan error jenis yang dihasilkan, jika ada |
| Lainnya | ||
| Menggunakan API 4.0 tanpa SDK (atau dengan library yang disediakan secara eksternal) | Kemungkinan error runtime, bergantung pada sensitivitas jenis bahasa | Tinjau kode untuk mengetahui dependensi pada jenis kolom ID dan tambahkan 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 Looker API & SDK. Library yang didukung komunitas tidak didukung secara resmi oleh Looker.
Pengguna API 3.1
Jika Anda menggunakan API 3.1, baca bagian ini. Bagian ini membahas fitur dan perubahan tambahan yang disediakan API 4.0 untuk Anda. Perlu diingat bahwa semua SDK yang didukung Looker dan SDK yang didukung Komunitas terutama mendukung API 4.0. Lihat Kebijakan dukungan SDK dan API untuk mengetahui informasi selengkapnya.
Fitur Tambahan API 4.0 GA
Untuk memudahkan, kami mencantumkan perubahan API 4.0 tambahan yang paling penting dan berguna bagi Anda:
- Pembuatan dan pengelolaan board, item board, dan bagian board. Lihat halaman dokumentasi Board untuk mengetahui informasi selengkapnya tentang board.
- Kueri info koneksi tambahan seperti database, skema, kolom, dan tabel. Tetapkan dan perbarui kolom koneksi tambahan.
- Pembuatan dan pengelolaan aplikasi dan pengguna OAuth. Lihat halaman dokumentasi OAuth untuk mengetahui informasi selengkapnya tentang OAuth.
- Telusuri grup dengan hierarki dan peran.
- Telusuri peran dengan jumlah pengguna.
- Dapatkan dan tetapkan setelan instance Looker. Lihat halaman dokumentasi Setelan untuk mengetahui informasi selengkapnya tentang setelan.
- Pembuatan dan pengelolaan pemberitahuan. Lihat halaman dokumentasi Pemberitahuan untuk mengetahui informasi selengkapnya tentang pemberitahuan.
- Pembuatan, pengelolaan, dan pengujian tunnel SSH dan server SSH. Lihat halaman dokumentasi SSH untuk mengetahui informasi selengkapnya tentang SSH.
- Pindahkan dan salin dasbor.
- Dapatkan URL relatif untuk dasbor baru.
- Pindahkan dan salin Look.
- Pembuatan dan pengelolaan rahasia, URL, dan pengguna embed yang ditandatangani dan embed yang tidak ditandatangani.
- Dapatkan token refresh untuk merefresh token akses login.
- Batasi dan offset hasil dari mendapatkan semua model LookML dan semua pengguna.
- Batasi dan offset hasil dari penelusuran pengguna.
- Dapatkan spesifikasi API instance Looker dalam Swagger 2.x JSON.
Perubahan Penghentian Penggunaan API 4.0 GA
API 4.0 GA menggantikan beberapa endpoint API 3.1 yang tidak digunakan lagi dengan fitur yang ditingkatkan. Endpoint berikut terpengaruh:
- Endpoint Halaman Beranda yang tidak digunakan lagi telah dihapus. Gunakan endpoint board, bukan halaman beranda. Lihat Menyajikan konten dengan board.
- Endpoint Ruang yang tidak digunakan lagi telah dihapus. Gunakan endpoint folder, bukan Ruang. Lihat Mengatur dan mengelola akses ke konten.
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 bagian Fitur Tambahan API 4.0 GA di halaman ini.
Penutup
Anda dapat menantikan fitur baru dan perubahan tambahan yang akan ditambahkan ke API 4.0 dan Anda selalu dapat menemukan perubahan terbaru di referensi API kami. Untuk mengetahui informasi selengkapnya, lihat Kebijakan dukungan API dan SDK serta Pembuatan Versi API. Kami tahu bahwa perubahan yang dapat menyebabkan gangguan tidak ideal. Kecuali jika terjadi masalah ekstrem, kami tidak akan melakukan perubahan yang dapat menyebabkan gangguan pada API 4.0 yang tersedia secara umum. Kami harap Looker API 4.0 yang tersedia secara umum dapat membantu Anda mengembangkan produk dengan lebih produktif dan mudah di platform Looker.