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 tidak kompatibel dan perubahan tambahan serta mempromosikan beberapa endpoint dari Beta ke Stabil. Lihat referensi API kami untuk mengetahui spesifikasi API 4.0 yang mendetail. Kami memperbarui SDK yang didukung Looker dan SDK yang didukung Komunitas untuk mendukung endpoint GA Looker API 4.0. Untuk mengetahui informasi selengkapnya, lihat Kebijakan dukungan API dan SDK serta Penetapan Versi API. Bagian selanjutnya dalam artikel ini menguraikan perubahan yang menyebabkan gangguan, mitigasi, dan fitur yang dapat Anda nantikan saat bermigrasi ke API 4.0 GA.
Siapa yang harus membaca ini?
Dokumen ini ditujukan bagi Anda jika Anda menggunakan Looker API melalui SDK yang didukung Looker, SDK yang didukung Komunitas, atau API itu sendiri. Baca bagian berikut yang sesuai dengan versi Looker API yang Anda gunakan.
Pengguna API 4.0 Pra-GA
Jika Anda menggunakan API 4.0, baca bagian ini. Dokumen ini mencakup perubahan yang dapat menyebabkan gangguan dan mitigasi yang tersedia saat Anda bermigrasi ke API 4.0 GA.
GA API 4.0 mencakup 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 penggunaan endpoint API 4.0 Anda:
| Penggunaan | Potensi Dampak1 | Pencegahan |
| Aplikasi seluler Looker | Penginstalan aplikasi seluler Looker yang sudah usang akan berhenti berfungsi | Minta pengguna mengupdate ke aplikasi seluler Looker versi terbaru |
| SDK 2 yang Didukung Looker | ||
| TypeScript SDK (4.0 API) | Tidak ada dampak | Tidak perlu tindakan apa pun |
| Python SDK (4.0 API) | Tidak ada dampak | Tidak perlu tindakan apa pun |
| Ruby SDK (4.0 API) | Tidak ada dampak | Tidak perlu tindakan apa pun |
| SDK2 yang Didukung Komunitas | ||
| Swift SDK | Pengecualian runtime | Update SDK ke v22.0+; lalu selesaikan error jenis yang muncul, jika ada |
| Kotlin SDK | Tidak ada dampak | Tidak perlu tindakan apa pun |
| LookR SDK | Tidak ada dampak | Tidak perlu tindakan apa pun |
| SDK C# | Tidak ada dampak | Tidak perlu tindakan apa pun |
| Go SDK | Pengecualian runtime | Update SDK ke v22.0+; lalu selesaikan error jenis yang muncul, 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: Mengasumsikan pola penggunaan umum yang dapat 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 mencakup fitur dan perubahan tambahan yang disediakan API 4.0 untuk Anda. Perlu diingat bahwa semua SDK yang didukung Looker dan SDK yang didukung Komunitas kami terutama mendukung API 4.0. Lihat Kebijakan dukungan SDK dan API untuk mengetahui informasi selengkapnya.
Fitur Tambahan API 4.0 GA
Untuk mempermudah, kami mencantumkan perubahan API 4.0 tambahan yang paling penting dan berguna untuk Anda:
- Pembuatan dan pengelolaan papan, item papan, dan bagian papan. Lihat halaman dokumentasi Board untuk mengetahui informasi selengkapnya tentang papan.
- 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.
- Menelusuri peran dengan jumlah pengguna.
- Mendapatkan dan menetapkan 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.
- Mendapatkan URL relatif untuk dasbor baru.
- Pindahkan dan salin Tampilan.
- Penyematan yang ditandatangani dan rahasia penyematan yang tidak ditandatangani, URL, serta pembuatan dan pengelolaan pengguna.
- Mendapatkan token refresh untuk memperbarui token akses login.
- Batasi dan offset hasil dari mendapatkan semua model LookML dan semua pengguna.
- Membatasi dan mengimbangi hasil dari pengguna yang menelusuri.
- Dapatkan spesifikasi API instance Looker dalam JSON Swagger 2.x.
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 papan, bukan halaman beranda. Lihat Menyajikan konten dengan papan.
- 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 mempermudah pengembangan Anda. Lihat repositori SDK kami.
- API 4.0 memperkenalkan beberapa fitur dan peningkatan baru seperti yang tercantum di bagian Fitur GA API 4.0 Tambahan 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 Penetapan Versi API. Kami tahu bahwa perubahan yang dapat menyebabkan gangguan tidaklah 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 yang tersedia secara umum ini dapat membantu Anda mengembangkan produk secara lebih produktif dan mudah di platform Looker.