Intelligent Media Management:GenerateWebofficeToken

• Sebelum menggunakan operasi ini, pastikan Anda telah memahami penagihan Intelligent Media Management. Untuk informasi selengkapnya, lihat Harga.

• Jangan melakukan akses lintas batas pada file OSS. Misalnya, jika file disimpan di bucket di Wilayah Singapura, jangan memulai permintaan Tampilan, baca, atau unduh dari daratan Tiongkok. Dalam skenario tersebut, kualitas tautan jaringan sangat terpengaruh oleh lingkungan jaringan lintas batas, yang dapat menyebabkan peningkatan latensi akses, kegagalan Tampilan, gangguan unduhan, atau koneksi yang tidak stabil. Stabilitas jaringan dan pengalaman akses tidak dapat dijamin. Pastikan titik akses dan bucket berada di Wilayah yang sama untuk menghindari ketidakpastian yang disebabkan oleh akses lintas batas.

• Kredensial akses kedaluwarsa dalam 30 menit, dan Token penyegaran kedaluwarsa dalam 1 hari.

• Pengatur waktu kedaluwarsa yang dikembalikan dalam UTC, yang tertinggal 8 jam dari UTC+8.

• format file input yang didukung:

  • Dokumen Word: doc, docx, txt, dot, wps, wpt, dotx, docm, dotm, dan rtf.

  • Dokumen presentasi (PPT): ppt, pptx, pptm, ppsx, ppsm, pps, potx, potm, dpt, dan dps.

  • Dokumen Excel: et, xls, xlt, xlsx, xlsm, xltx, xltm, dan csv.

  • Dokumen PDF: pdf.

• Ukuran file maksimum yang didukung adalah 200 MB.

• Jumlah halaman dokumen maksimum yang didukung adalah 5.000.

• Untuk Proyek yang dibuat sebelum 1 Desember 2023, penagihan didasarkan pada jumlah pembukaan dokumen. Saat ini, penagihan didasarkan pada jumlah panggilan API. Untuk beralih ke mode penagihan baru, buat Proyek baru. Perhatikan bahwa setiap panggilan API hanya dapat digunakan oleh satu pengguna. Jika panggilan digunakan kembali, hanya pengguna terakhir yang dapat mengakses dokumen secara normal, dan izin akses pengguna lain akan dicabut.

• Aktifkan Message Service (MNS) di Wilayah yang sama dengan Intelligent Media Management, buat Topik dan Antrian, lalu konfigurasikan langganan. Anda dapat meneruskan nama Topik MNS menggunakan parameter NotifyTopicName untuk menerima Notifikasi Paket tentang penyimpanan file. Untuk informasi selengkapnya tentang MNS SDK, lihat Menerima dan menghapus Paket. Untuk contoh format JSON bidang Message dalam Notifikasi Paket penyimpanan file, lihat format notifikasi pesan WebOffice.

Contoh skenario tipikal

Contoh berikut menjelaskan beberapa skenario tipikal berdasarkan struktur parameter:

Tampilan file hanya-baca (diperlukan untuk Tampilan file PDF)

Mode Tampilan dokumen. Dokumen hanya dapat Tampilan dan tidak dapat diedit:

 {
    "ProjectName"   : "test-project",
    "SourceURI" : "oss://test-bucket/test-object.pdf",
    "Filename" : "test-object.docx",
    "PreviewPages" : "5",
    "Permission" : "{'Readonly':'true'}"
}

Tampilan file dengan ekstensi nama file huruf besar

Untuk Tampilan file dengan ekstensi nama file huruf besar, atur parameter Filename dengan ekstensi huruf kecil:

 {
    "ProjectName"   : "test-project",
    "SourceURI" : "oss://test-bucket/test-object.DOCX",
    "Filename" : "test-object.docx",
    "PreviewPages" : "5",
    "Permission" : "{'Readonly':'true'}"
}

Tampilan hanya 5 halaman pertama dokumen

Dokumen memiliki total 10 halaman. Hanya 5 halaman pertama yang ditampilkan:

 {
    "ProjectName"   : "test-project",
    "SourceURI" : "oss://test-bucket/test-object.docx",
    "Filename" : "test-object.docx",
    "PreviewPages" : "5",
    "Permission" : "{'Readonly':'true'}"
}

Mengatur kata sandi untuk Tampilan dokumen

Atur kata sandi untuk Tampilan dokumen, atau langsung buka file sumber yang dilindungi kata sandi tanpa memerlukan kata sandi:

 {
    "ProjectName"   : "test-project",
    "SourceURI" : "oss://test-bucket/test-object.docx",
    "Filename" : "test-object.docx",
    "Password" : "123456",
    "Permission" : "{'Readonly':'true'}"
}

Menambahkan Watermark ke Tampilan dokumen

Tambahkan Watermark saat Tampilan dokumen:

 {
    "ProjectName"   : "test-project",
    "SourceURI" : "oss://test-bucket/test-object.docx",
    "Filename" : "test-object.docx",
    "Watermark" : "{'Type':'1','Value':'nilai Watermark','Font':'bold 20px Serif'}",
    "Permission" : "{'Readonly':'true'}"
}

Menyembunyikan Bilah alat selama Tampilan dokumen

Sembunyikan Bilah alat saat Tampilan dokumen:

 {
    "ProjectName"   : "test-project",
    "SourceURI" : "oss://test-bucket/test-object.docx",
    "Filename" : "test-object.docx",
    "Hidecmb" : "true",
    "Permission" : "{'Readonly':'true'}"
}

Mengedit dokumen online dengan izin untuk melihat versi historis, menyalin, mencetak, dan mengekspor ke PDF

Edit dokumen online dengan izin untuk melihat versi historis, menyalin, mencetak, dan mengekspor ke PDF:

 {
    "ProjectName"   : "test-project",
    "SourceURI" : "oss://test-bucket/test-object.docx",
    "Filename" : "test-object.docx",
    "Permission" : "{'Readonly':'false','History':'true','Copy':'true','Print':'true','Export':'true'}"
}
```.

Error umum.

Proyek yang ditentukan oleh ProjectName tidak ditemukan. Buka konsol IMM dan periksa apakah proyek ada di wilayah tersebut.

{
    "Code": "ResourceNotFound",
    "Message": "The specified resource acs:imm::xxx:project/xxx is not found"
}
```.

Parameter User wajib diisi. Periksa apakah parameter ini ditentukan.

{ "Code": "InvalidArgument.User", "Message": "The parameter User is required but not provided" }

Parameter User tidak valid. Periksa apakah nilai parameter dalam format JSON yang valid.

{ "Code": "InvalidJSON parsing error, User", "Message": "Specified parameter JSON parsing error, User is not valid." }

Parameter Permission tidak valid. Periksa apakah nilai parameter dalam format JSON yang valid.

{ "Code": "InvalidJSON parsing error, Permission", "Message": "Specified parameter JSON parsing error, Permission is not valid." }

Parameter Watermark tidak valid. Periksa apakah nilai parameter dalam format JSON yang valid.

{ "Code": "InvalidJSON parsing error, Watermark", "Message": "Specified parameter JSON parsing error, Watermark is not valid." }

format parameter PreviewPages tidak valid. Periksa nilai parameter PreviewPages.

{ "Code": "InvalidPreviewPages", "Message": "Specified parameter PreviewPages is not valid." }

File OSS yang ditentukan oleh SourceURI tidak ada. Periksa apakah file ada di bucket.

{ "Code": "ResourceNotFound", "Message": "The specified resource oss://xx is not found" }