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:
- Pembuatan dan pengelolaan bagian papan, item, dan papan. Lihat Halaman dokumentasi board untuk mengetahui informasi selengkapnya tentang papan tulis.
- Buat kueri untuk info koneksi tambahan seperti database, skema, kolom, dan tabel. Tetapkan dan perbarui kolom koneksi tambahan.
- Pembuatan dan pengelolaan pengguna serta aplikasi OAuth. Lihat halaman dokumentasi OAuth untuk informasi lebih lanjut tentang OAuth.
- Telusuri grup dengan hierarki dan peran.
- Telusuri peran dengan jumlah pengguna.
- Mendapatkan dan menetapkan setelan instance Looker. Lihat Halaman dokumentasi setelan untuk informasi selengkapnya tentang setelan.
- Pembuatan dan pengelolaan notifikasi. Lihat Halaman dokumentasi Notifikasi untuk informasi selengkapnya tentang notifikasi.
- Tunnel SSH serta pembuatan, pengelolaan, dan pengujian server SSH. Lihat halaman dokumentasi SSH untuk mengetahui informasi lebih lanjut tentang SSH.
- Pindahkan dan salin dasbor.
- Mendapatkan URL relatif untuk dasbor baru.
- Pindahkan dan salin Tampilan.
- Penyematan yang ditandatangani dan rahasia sematan yang tidak ditandatangani, URL, serta pembuatan dan pengelolaan pengguna.
- Dapatkan token refresh untuk memperbarui token akses login.
- Membatasi dan mengimbangi hasil agar tidak mendapatkan semua model LookML dan semua pengguna.
- Membatasi dan mengimbangi hasil dari pengguna yang menelusuri.
- Dapatkan spesifikasi API instance Looker di Swagger 2.x JSON.
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:
- Endpoint Halaman beranda yang tidak digunakan lagi telah dihapus. Gunakan endpoint papan, bukan halaman beranda. Lihat Mempresentasikan konten dengan papan.
- Endpoint Space yang tidak digunakan lagi telah dihapus. Gunakan endpoint folder, bukan Spasi. 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 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.