Bagaimana Anda menggunakan api di google sheets?

Sharperlight Query Builder tidak hanya mampu mengirimkan data dari database tradisional, tetapi juga mengakses data dari sistem file, dokumen, dan lainnya – termasuk titik akhir API seperti Google Sheets API

Artikel ini akan mengeksplorasi penggunaan Sharperlight Query Builder untuk mengambil data dari dokumen Google Sheets melalui 'spreadsheet. nilai-nilai. dapatkan' metode Google Sheets API
Secara garis besar, langkah-langkah untuk melakukannya adalah

• Konfigurasikan Google Cloud Platform dan aktifkan Google Sheets API
• Hasilkan dan ambil kunci API
• Izinkan sheet Anda dapat diakses melalui kunci API dan ambil parameter Spreadsheet ID dan Range
• Buat dan format permintaan API di Query Builder

Prasyarat

Agar berhasil mengakses data melalui Google Sheets API, organisasi Anda harus mengonfigurasi Google Cloud Platform dengan benar melalui Developer Console
Di dalam Developer Console, Google Sheets API harus diaktifkan agar titik akhir dapat ditanyakan. Untuk mengaktifkan API, atau untuk memeriksa apakah saat ini diaktifkan, cukup cari Google Sheets API di bilah pencarian di bagian atas konsol, dan jelajahi halaman manajemen API

Setelah Anda menemukan halaman Manajemen Google Sheets API, klik tombol 'Aktifkan' untuk memungkinkan kueri titik akhir. Setelah Anda melakukannya, centang hijau akan menunjukkan bahwa itu berhasil diaktifkan

Keamanan & Otentikasi

Ada dua bentuk otentikasi Permintaan Google Sheets API yang dapat diterima
Bentuk autentikasi yang paling sederhana memerlukan penggunaan kunci API. Setelah kunci API dibuat, ini dapat digunakan untuk mengotentikasi permintaan apa pun yang telah diizinkan aksesnya - namun memiliki beberapa kekurangan dengan akses ke dokumen pribadi dan harus dikelola dengan benar untuk mencegah masalah keamanan
Bentuk autentikasi kedua menggunakan OAuth 2. 0. Hal ini memungkinkan penerapan keamanan dan izin tingkat pengguna, memungkinkan pengguna untuk menanyakan spreadsheet mereka sendiri, atau spreadsheet yang telah mereka akses. Meskipun ini adalah opsi yang lebih aman, fleksibel, dan andal – ini bisa lebih rumit untuk dikonfigurasi tergantung pada organisasi Anda dan kebutuhan administratifnya

Bagaimana cara mendapatkan kredensial yang saya butuhkan?

Sebagai mengonfigurasi dan menavigasi alur dan persetujuan pengguna dengan OAuth 2. 0 cukup rumit dan di luar cakupan dokumen ini, kami akan mengeksplorasi penggunaan kunci API untuk mengizinkan akses baca ke lembar Google

Karena kunci API tidak memiliki identifikasi 'pengguna' untuk menetapkan sheet tertentu, Google Sheets harus diaktifkan untuk berbagi terbuka melalui tautan agar dapat diakses oleh kunci API. Bergantung pada sensitivitas data, ini mungkin menjadi masalah keamanan

Setelah Anda mengambil Kunci API Anda dan mengonfigurasi ruang lingkup dan batasannya jika perlu, salin dan simpan untuk nanti

Membuat permintaan API di Query Builder

Setelah kami mengaktifkan Sheets API dan membuat kunci API, kami kemudian dapat mulai membuat permintaan API kami

Query Builder Sharperlight biasanya digunakan untuk menyediakan akses ke data dari produk melalui 'Datamodels'. Model data, atau Produk yang Anda kueri dipilih di antarmuka Pembuat Kueri
Produk 'Sistem' berisi banyak utilitas dan alat kueri yang bermanfaat, seperti diagnostik Layanan, laporan penggunaan, dan dalam hal ini, kita dapat menggunakannya untuk menanyakan Google Sheets API

'Tabel' produk Sistem mewakili berbagai alat kueri, kueri administratif dan diagnostik yang dapat kami lakukan. Untuk permintaan API, kami mencari 'tabel' berjudul "Tabel Halaman Web, CSV, JSON, XML, atau OData"

Untuk menanyakan titik akhir API, kami dapat membuat URL permintaan menggunakan spesifikasi Google Sheets API. Kami akan menggunakan 'spreadsheet. nilai-nilai. get‘, karena metode ini memungkinkan kita untuk membaca data dari spreadsheet kita secara langsung. Sintaks permintaan untuk metode ini adalah sebagai berikut

https://sheets.googleapis.com/v4/spreadsheets/{spreadsheetId}/values/{range}?key={apiKey}

Nilai spreadsheetId, range, dan apiKey adalah semua variabel yang akan berubah tergantung pada Spreadsheet, tab (rentang), dan kunci API mana yang kita gunakan – jadi untuk membuat kueri ini lebih dapat digunakan kembali, kita dapat menggunakan “Prompt Only Filters”

Pertama, mari ubah sedikit URL kita agar Pembuat Kueri dapat mengganti variabel kita dengan nilai "Prompt Only Filter". Referensi filter di Sharperlight mirip dengan yang digunakan di atas, tetapi diawali dengan simbol @, mis. g. {@Filter_Name}
Dengan menempatkan @ di depan nama variabel, tetapi di dalam kurung kurawal, mereka akan mereferensikan parameter filter

https://sheets.googleapis.com/v4/spreadsheets/{@spreadsheetId}/values/{@range}?key={@apiKey}

Spesifikasi lengkap API dapat ditemukan di Sheets API. Pengembang Google

Selanjutnya, kita perlu menyalin URL kita ke properti "Tautan URL" Pembuat Kueri

Ini akan menghasilkan peringatan bahwa kita belum membuat variabel filter (spreadsheetId, range, dan apiKey), jadi mari tangani sekarang

Anda dapat membuat 'variabel' tambahan menggunakan Prompt Only Filters. Klik kanan di mana saja di bagian filter (panel atas Pembuat Kueri), dan navigasikan daftar perintah tarik-turun untuk menemukan Lainnya > Teks. Tambahkan nama bidang yang ingin Anda buat (mis. g. "spreadsheetId") saat diminta, dan tekan OK

Terakhir, seret filter baru ke bagian atas panel filter, di atas "Tautan URL". Ulangi langkah ini dengan 'range' dan 'apiKey' sehingga kita memiliki ketiga variabel yang diperlukan, seperti di bawah ini

Harus berhati-hati untuk memastikan nama atribut (disorot dengan warna hijau di atas) cocok dengan nama variabel yang diperlukan dari URL kami. Jika tidak, ini dapat diubah di menu opsi, dengan mengklik kanan pada setiap nilai filter dan memilih opsi dari menu dropdown
Anda mungkin juga ingin menyetel filter ke "hanya nilai tunggal" karena 'sel' tambahan tidak diperlukan untuk nilai ini

Sekarang setelah kita menyiapkan tiga variabel, kita perlu memasukkan nilainya. Anda seharusnya sudah menyimpan Kunci API dari sebelumnya – jika tidak, kembali ke bagian “Keamanan dan Otentikasi” untuk detailnya

Buka Lembar Google yang ingin Anda bagikan
Nilai 'rentang' akan menjadi nama tab yang ingin Anda baca (mis. g. Sheet1) – di Excel ini akan disebut sebagai lembar kerja

"ID Spreadsheet" dapat diambil dari bilah URL. Ini adalah rangkaian panjang karakter setelah “/d/”

Untuk mengizinkan akses kunci API ke sheet Anda, dan klik tombol bagikan berwarna hijau di pojok kanan atas. Di jendela pop-up, klik "Ubah ke siapa pun yang memiliki tautan"

Sekarang setelah kita memiliki semua detail yang diperlukan, kita dapat memasukkan nilainya ke dalam Pembuat Kueri dan membuat permintaan

Kami telah berhasil mengkueri API pada saat ini – dan beberapa pemformatan kecil diperlukan agar kumpulan data dapat dibaca
Karena struktur bersarang dari format 'JSON' yang dikembalikan oleh API, kami perlu memberi tahu Pembuat Kueri untuk 'memulai' bidang nilai. Seret dan lepas 'nilai' dari pohon pemilihan ke sel filter 'Posisi Awal', atau cukup ketikkan 'nilai' ke dalam sel filter

Setelah kami 'memperluas' bidang nilai dan tidak lagi bersarang, kami dapat memilih kolom kami dan secara opsional id baris, dan mempratinjau output yang diformat dari permintaan API

Dan akhirnya, kami memiliki kumpulan data lengkap kami. Kueri ini dapat digunakan untuk mendorong keluaran untuk kueri Sharperlight apa pun, termasuk di dalam Publisher atau Excel. Saat disegarkan, itu akan meminta informasi terbaru dari Google Sheets API

Ada opsi tambahan untuk memformat dan menyesuaikan keluaran permintaan API – untuk informasi lebih lanjut lihat artikel Meminta JSON

Bagaimana cara menarik data dari Google Sheets API?

Bagaimana cara mengaktifkan API di Google Sheets?

Bisakah Google Spreadsheet berinteraksi dengan API?

Bagaimana cara membuat Google Sheet API?