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 menyebabkan error dan tambahan serta mempromosikan beberapa endpoint dari Beta ke Stabil. Lihat referensi API untuk mengetahui spesifikasi API 4.0 yang mendetail. Kami telah mengupdate SDK yang didukung Looker dan yang didukung Komunitas untuk mendukung endpoint Looker API 4.0 GA. Untuk informasi selengkapnya, lihat Kebijakan dukungan API dan SDK serta Pembuatan Versi API. Bagian lain dari artikel ini menguraikan perubahan yang dapat menyebabkan gangguan, mitigasi, dan fitur yang dapat Anda harapkan saat bermigrasi ke API 4.0 GA.
Siapa yang harus membaca 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. Panduan 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 entitas dari jenis integer
numerik menjadi jenis string
. Misalnya, endpoint GET /groups/{group_id}
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 berhenti berfungsi | Minta pengguna mengupdate aplikasi seluler Looker ke versi terbaru |
SDK2 yang Didukung Looker | ||
TypeScript SDK (4.0 API) | Tidak ada dampak | Tidak perlu tindakan |
Python SDK (API 4.0) | Tidak ada dampak | Tidak perlu tindakan |
Ruby SDK (API 4.0) | Tidak ada dampak | Tidak perlu tindakan |
SDK 2 yang Didukung Komunitas | ||
Swift SDK | Pengecualian runtime | Update SDK ke v22.0+; lalu selesaikan error jenis yang dihasilkan, jika ada |
Kotlin SDK | Tidak ada dampak | Tidak perlu tindakan |
LookR SDK | Tidak ada dampak | Tidak perlu tindakan |
C# SDK | Tidak ada dampak | Tidak perlu tindakan |
Go SDK | 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 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. Panduan ini membahas fitur dan perubahan tambahan yang disediakan API 4.0 untuk Anda. Perlu diingat, semua SDK yang didukung Looker dan yang didukung Komunitas sebagian besar 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 API 4.0 tambahan yang paling penting dan berguna untuk Anda:
- Pembuatan dan pengelolaan papan tulis virtual, item papan tulis virtual, dan bagian papan tulis virtual. Lihat Halaman dokumentasi board untuk mengetahui informasi selengkapnya tentang board.
- Buat kueri info koneksi tambahan seperti database, skema, kolom, dan tabel. Menetapkan dan memperbarui kolom koneksi tambahan.
- Pembuatan dan pengelolaan aplikasi serta pengguna OAuth. Lihat halaman dokumentasi OAuth untuk informasi selengkapnya tentang OAuth.
- Menelusuri grup dengan hierarki dan peran.
- Menelusuri 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 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.
- Batasi dan offset hasil dari penelusuran pengguna.
- 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 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 GA API 4.0 Tambahan di halaman ini.
Rangkuman
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 informasi selengkapnya, lihat Kebijakan dukungan API dan SDK serta Pembuatan Versi API. Kami tahu bahwa perubahan yang menyebabkan gangguan tidak ideal. Kecuali jika masalah ekstrem muncul, 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 dapat membantu Anda mengembangkan aplikasi dengan lebih produktif dan mudah di platform Looker.