Optimalkan pilihan Simpan dan kategorikan konten sesuai dengan pengaturan Anda.
Penting: Google Sheets API v3 tidak tersedia lagi pada tanggal 2 Agustus 2021. Gunakan panduan ini untuk bermigrasi ke Sheets API v4. Untuk informasi selengkapnya tentang perubahan ini, silakan lihat postingan blog kami.
Jika Anda memiliki aplikasi berbasis Google Sheets API v3, Anda dapat bermigrasi ke Google Sheets API v4. Versi v4 berbasis JSON, memiliki antarmuka yang lebih mudah digunakan, dan menambahkan fungsionalitas signifikan yang tidak tersedia di v3.
Halaman ini memberikan perbandingan perintah Sheets API v3 lama dan operasi setaranya di Sheets API v4. Perbandingan ini terutama berfokus pada pengumpulan nilai di spreadsheet. Aspek lain seperti menambahkan sheet dan memperbarui properti sheet ditangani oleh kumpulan spreadsheet . values. Perhatikan bahwa struktur JSON API versi 4 tidak kompatibel dengan struktur XML yang digunakan dalam versi 3.
Untuk informasi selengkapnya tentang sumber daya yang tersedia dengan API Sheets v4, lihat Panduan Referensi API.
API versi 3 mengacu pada lembar spreadsheet tertentu sebagai “lembar kerja”. Ini sinonim dengan istilah “sheet” yang digunakan oleh API versi 4.
API sering kali mengharuskan Anda menentukan ID spreadsheet yang sedang Anda gunakan. Selain itu, Anda sering dimintai ID sheet yang sedang Anda kerjakan. Nilai-nilai ini muncul sebagai bagian dari URL titik akhir API, parameter kueri, atau isi permintaan. Di halaman ini, placeholder spreadsheetId dan sheetId masing-masing mewakili pengidentifikasi spreadsheet dan sheet. Gantikan pengidentifikasi sebenarnya untuk lokasi ini saat menggunakan metode yang dijelaskan di halaman ini.
API versi 3 juga memberikan pengidentifikasi ke baris yang diambil menggunakan saluran daftar. Halaman ini mewakili ini dengan placeholder rowId.
Minta izin khusus dari pengguna saat aplikasi berjalan. Wilayah yang Anda tentukan dalam permohonan Anda menentukan izin yang Anda minta.
Sheets API v3 berfungsi dengan satu cakupan izin:
https://spreadsheets. google. com/feeds
Alias.
https://www. googleapis. com/auth/spreadsheets
Ini dapat digunakan dalam format area apa pun.
Sheets API V4 menggunakan satu atau lebih area dari set berikut:
https://www. googleapis. com/auth/spreadsheets. readonly https://www. googleapis. com/Auth/spreadsheets. com UTH/drive. readonly https: //www. googleapis . com/drive. readonly https: //www. googleapis . com/auth/drive auth/drive
Gunakan area bac a-setly untuk aplikasi yang tidak perlu mengubah ke kursi pengguna atau properti kursi. Jika aplikasi tidak perlu berbagi disk, gunakan area spreadsheet ali h-alih area aksi disk.
Versi lama API menggunakan istilah “terlihat” untuk menunjukkan aksesibilitas spreadsheet yang ditentukan.
Sheets API V3 memberikan visibilitas langsung ke titik akhir. Spreadsheet publik “diterbitkan di web” sehingga Anda dapat mengaksesnya tanpa otentikasi melalui API, tetapi dalam hal spreadsheet pribadi, otentikasi memerlukan otentikasi. Visualitas ditentukan setelah ID tabel di titik akhir:
https://spreadsheets. google. com/feeds/worksheets/spreadsheetid/Pribadi /penuh
API Sheets baru V4 tidak memiliki deklarasi yang terlihat secara eksplisit. Panggilan API dilakukan dengan menggunakan pengidentifikasi spreadsheet. Jika Anda tidak memiliki wewenang untuk mengakses spreadsheet yang ditentukan dalam aplikasi, kesalahan akan dikembalikan. Jika tidak, panggilan akan berlanjut.
Dalam Sheets API V3, istilah “proyeksi” digunakan untuk merujuk pada set data (semua data atau subset tetap yang ditentukan dalam API) yang dikembalikan oleh panggilan API yang ditentukan. Proyeksi tidak digunakan dalam Sheets API V4. Sebaliknya, Anda akan dapat mengontrol data mana yang dikembalikan lebih baik.
Dengan Sheets API V3, hanya ada dua pengaturan proyeksi yang mungkin. Proyeksi penuh mengembalikan semua informasi yang tersedia, dan subset dasar (lembar, daftar, saluran sel) dikembalikan. Seperti visibilitas, proyeksi harus ditentukan sebagai titik akhir API (setelah pengaturan visibilitas):
https://spreadsheets. google. com/feeds/worksheets/spreadsheetid/ Publik/ dasar.
Subset data yang lebih kecil daripada yang disediakan dalam proyeksi dasar berguna untuk meningkatkan efisiensi kode, tetapi tidak dapat disesuaikan.
Sheets API V4 dapat mengembalikan dataset lengkap, tetapi tidak menentukan subset tetap seperti pengaturan visibilitas dasar Sheets API V3. Metode pengumpulan spreadsheet membatasi jumlah data yang dikembalikan menggunakan kueri dan parameter lapangan.
Misalnya, pertanyaan berikut hanya mengembalikan header spreadsheet tertentu:
Dapatkan https://sheets. googleapis. com/v4/spreadsheets/spreadsheetidField = sheets. properties. title
Sebagai gantinya, Anda dapat membuat file spreadsheet baru menggunakan metode drive API file. create. Sebagai gantinya, Anda dapat membuat file spreadsheet baru menggunakan metode drive API file. create. Untuk melakukan ini, aplikasi harus mendeklarasikan ruang lingkup https://www. googleapis. com/auth/drive.
Metode Drive API Files. Create dapat digunakan dalam Sheets API V4, tetapi dalam hal ini aplikasi harus memberikan ruang lingkup https://www. googleapis. com/Auth/Drive.
Secara setara dengan ini, Sheets API V4 memiliki metode spreadsheet. Misalnya, perintah berikut membuat spreadsheet baru dan namanya adalah “Newtitle”:
Posting https://sheets. googleapis. com/v4/spreadsheets
Dengan feed API V3 Sheets, aplikasi ini bisa mendapatkan daftar semua spreadsheet yang telah diautentikasi. Titik akhir dari pakan spreadsheet
Dapatkan https://spreadsheets. google. com/feedsheets/private/full
Sheets API V4 tidak mendukung operasi khusus ini. Dianjurkan agar Anda memigrasikan aplikasi dan menggunakan area disc. file dan Google Select Tools untuk memilih spreadsheet.
Jika diperlukan spreadsheet dengan daftar, itu dapat digandakan menggunakan permintaan mimetype menggunakan metode file.
Dapatkan https://www. googleapis. com/drive/v3/files?
Diperlukan ruang lingkup terbatas untuk menggunakan metode file. Daftar API drive untuk menghasilkan semua spreadsheet pengguna.
Sheets API V3 menyediakan saluran untuk mengakses metadata lembar yang termasuk dalam spreadsheet yang ditentukan (akses garis dan data sel dengan saluran yang berbeda). Metadata mencakup informasi seperti header kursi dan informasi ukuran.
Metode Spreadsheets. get API Sheets v4 menyediakan akses ke informasi ini dan informasi lainnya.
Saluran lembar kerja dapat diakses melalui titik akhir API ini (menggunakan header otorisasi yang sesuai):
DAPATKAN https://spreadsheets. google. com/feeds/worksheets/spreadsheetid/pribadi/penuh.
Tanggapan terhadap permintaan ini memiliki struktur serupa:
https://spreadsheets. google. com/feeds/worksheets/spreadsheetId/private/full 2006-11-17T18:23:45. 173Z toko kelontong fitzwilliam darcy fitz@example. com 1 1 1 https://spreadsheets. google. com/feeds/worksheets/spreadsheetId/private/full/sheetId 2006-11-17T18:23:45. 173Z lembar 1 lembar 1