Topik ini menjelaskan fitur pengeditan file online dari Drive and Photo Service. Drive and Photo Service memungkinkan Anda mengedit file secara online di BasicUI yang disediakan oleh Drive and Photo Service. Anda juga dapat memanggil Operasi API dari Drive and Photo Service untuk mengedit file secara online dengan merujuk pada topik ini.
Fitur pengeditan file online adalah fitur bernilai tambah. Secara default, fitur ini dinonaktifkan untuk Drive and Photo Service Developer Edition. Hubungi kami untuk mengaktifkan fitur pengeditan file online.
Anda akan dikenakan biaya untuk fitur bernilai tambah yang disediakan oleh Drive and Photo Service Developer Edition. Untuk informasi lebih lanjut, lihat Item yang Dapat Ditagih Bernilai Tambah.
Format file yang didukung
Format file spreadsheet | Format file teks | Format file presentasi |
ET, XLS, XLT, XLSX, XLSM, XLTX, XLTM, dan CSV | DOC, DOCX, TXT, DOT, WPS, WPT, DOTX, DOCM, DOTM, dan RTF | PPT, PPTX, PPTM, PPSX, PPSM, PPS, POTX, POTM, DPT, dan DPS |
Batasan
Hingga 365 pengguna dapat mengedit file secara kolaboratif online. Jika jumlah pengguna online bersamaan melebihi 50, mungkin terjadi tersendat pada halaman.
File yang akan diedit secara online dapat berukuran hingga 200 MB. Jika ukuran file melebihi 200 MB, fitur pengeditan file online tidak tersedia.
Catatan kolaborasi disimpan selama 180 hari.
Proses dan contoh kode panggilan API
1. Proses panggilan API
Catatan:
Anda dapat memanggil operasi untuk mendapatkan URL pengeditan online dan token, serta menggunakan informasi yang diperoleh untuk mengakses halaman pengeditan online.
Token pengeditan online memiliki masa berlaku. Jika token kedaluwarsa, Anda harus memanggil Operasi API untuk menyegarkan token. Anda dapat menggunakan parameter office_refresh_token untuk mendapatkan token baru.
Halaman pengeditan online diakses berdasarkan teknologi frontend. Kami merekomendasikan Anda menggunakan SDK for JavaScript yang disediakan oleh Drive and Photo Service untuk mengedit file secara online. Untuk informasi lebih lanjut, lihat deskripsi metode getOfficeEditUrl dan refreshOfficeEditToken serta contoh pratinjau file dalam dokumentasi SDK for JavaScript.
2. Mendapatkan URL pengeditan online
POST /v2/file/get_office_edit_url
Parameter Permintaan
Parameter | Posisi | Tipe | Diperlukan | Deskripsi |
Authorization | header | String | Token akses. | |
x-share-token | header | String | Token berbagi. Anda dapat menentukan parameter ini jika ingin berbagi file. Jika Anda menentukan parameter ini, Anda tidak perlu menentukan parameter Authorization. | |
drive_id | body | String | Tidak | ID drive. Parameter drive_id dan share_id saling eksklusif. Anda harus menentukan salah satu dari keduanya. |
share_id | body | String | Tidak | ID berbagi. Anda dapat menentukan parameter ini jika ingin berbagi file. Jika Anda menentukan parameter ini, Anda tidak dapat menentukan parameter drive_id. |
file_id | body | String | Ya | ID file yang akan diedit. |
option | body | JSON | Tidak | Opsi yang digunakan untuk mengontrol pengeditan file. |
Parameter dalam Parameter Permintaan Option
Parameter | Posisi | Tipe | Diperlukan | Deskripsi |
copy | body | Boolean | Tidak | Menentukan apakah pengguna diizinkan menyalin isi file. |
readonly | body | Boolean | Tidak | Menentukan apakah file bersifat hanya-baca. Jika Anda ingin mengedit file secara online, atur parameter ini ke false. |
Parameter Respons
Parameter | Diperlukan | Tipe | Deskripsi |
edit_url | Ya | String | URL pengeditan online. |
office_access_token | Ya | String | Token akses, yang berlaku selama 30 menit. |
office_refresh_token | Ya | String | Token penyegaran, yang berlaku selama satu hari. |
Contoh Permintaan
{
"drive_id": "testDriveId",
"file_id": "testFileId",
"option": {
"readonly": false,
"copy": true
}
}Contoh Respons
{
"edit_url": "testEditUrl",
"office_access_token": "testOfficeAccessToken",
"office_refresh_token": "testOfficeRefreshToken"
}3. Menyegarkan token pengeditan online
POST /v2/file/refresh_office_edit_token
Parameter Permintaan
Parameter | Posisi | Tipe | Diperlukan | Deskripsi |
Authorization | header | String | Token akses. | |
x-share-token | header | String | Token berbagi. Anda dapat menentukan parameter ini jika ingin berbagi file. Jika Anda menentukan parameter ini, Anda tidak perlu menentukan parameter Authorization. | |
share_id | body | String | Tidak | ID berbagi. Anda dapat menentukan parameter ini jika ingin berbagi file. |
office_access_token | body | String | Ya | Token akses. |
office_refresh_token | body | String | Ya | Token penyegaran. |
Parameter Respons
Parameter | Diperlukan | Tipe | Deskripsi |
office_access_token | Ya | String | Token akses baru, yang berlaku selama 30 menit. |
office_refresh_token | Ya | String | Token penyegaran baru, yang berlaku selama satu hari. |
Contoh Permintaan
{
"office_access_token": "testOfficeAccessToken",
"office_refresh_token": "testOfficeRefreshToken"
}Contoh Respons
{
"office_access_token": "testOfficeAccessToken",
"office_refresh_token": "testOfficeRefreshToken"
}4. Mengakses halaman pengeditan online
Halaman pengeditan online diakses berdasarkan teknologi frontend. Kami merekomendasikan Anda menggunakan SDK for JavaScript yang disediakan oleh Drive and Photo Service untuk mengedit file secara online. Untuk informasi lebih lanjut, lihat dokumentasi SDK for JavaScript.
Jika Anda tidak menggunakan SDK for JavaScript yang disediakan oleh Drive and Photo Service, Anda dapat menggunakan fitur pratinjau file dari Alibaba Cloud Intelligent Media Management (IMM). Untuk informasi lebih lanjut, lihat deskripsi SDK for JavaScript yang disediakan untuk frontend dalam Panduan Pengguna IMM. Saat menggunakan SDK for JavaScript yang disediakan untuk frontend, ganti operasi yang digunakan untuk mendapatkan informasi token dengan Operasi API dari Drive and Photo Service yang digunakan untuk mendapatkan URL pengeditan online, dan ganti operasi yang digunakan untuk mendapatkan token penyegaran dengan Operasi API dari Drive and Photo Service yang digunakan untuk menyegarkan token pengeditan online.
FAQ
1. Izin apa yang diperlukan untuk mengedit file secara online?
Fitur pengeditan file online dari klien web dan klien desktop memerlukan izin pembaruan pada file.
2. Apa yang harus saya lakukan jika saya tidak dapat mengedit file meskipun saya berwenang untuk mengedit file secara online?
Anda dapat melakukan langkah-langkah berikut untuk memecahkan masalah:
1. Fitur pengeditan file online adalah fitur bernilai tambah. Periksa apakah fitur ini diaktifkan.
2. Periksa apakah format file didukung oleh fitur pengeditan file online.
3. Periksa apakah ukuran file melebihi 200 MB.
4. Hubungi administrator super dari Drive and Photo Service untuk melakukan operasi berikut: Masuk ke Admin Console. Di panel navigasi di sebelah kiri, pilih Enterprise Customize > File Settings. Di halaman File Settings, lihat pengaturan unggah file. Jika format file yang akan diedit tidak terdaftar dalam format file yang dapat diunggah, Anda tidak dapat mengedit file secara online. Jika ukuran file melebihi batas atas yang ditentukan untuk file tunggal yang diunggah, Anda tidak dapat menyimpan file yang diedit secara online.