All Products
Search

This Product

    Intelligent Media Management:CreateOfficeConversionTask

    Document Center

    Intelligent Media Management:CreateOfficeConversionTask

    Last Updated:Jun 12, 2026

    Membuat tugas konversi dokumen yang mengonversi dokumen (Word, PPT, Excel, PDF) yang disimpan di Object Storage Service (OSS) menjadi gambar, teks, atau PDF.

    Deskripsi operasi

    • Sebelum Anda menggunakan operasi ini, pastikan bahwa Anda sudah memahami penagihan Intelligent Media Management (IMM). Untuk informasi selengkapnya, lihat Harga.

      Penting Tugas asinkron tidak menjamin ketepatan waktu.

    • Format file input yang didukung:

      • Dokumen Word: doc, docx, wps, wpss, docm, dotm, dot, dan dotx.

      • Dokumen PowerPoint: pptx, ppt, pot, potx, pps, ppsx, dps, dpt, pptm, potm, ppsm, dan dpss.

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

      • Dokumen PDF: pdf.

    • Format file output yang didukung:

      • Gambar: png dan jpg.

      • Teks: txt.

      • PDF: pdf.

    • Ukuran maksimum satu file adalah 200 MB. Batas ini tidak dapat disesuaikan.

    • Jika file berukuran besar atau konten file kompleks, konversi mungkin mengalami waktu tunggu habis.

    • Jumlah maksimum permintaan per detik untuk satu pengguna adalah 50.

    • Setelah tugas mulai dieksekusi, informasi tugas hanya disimpan selama 7 hari. Setelah 7 hari, informasi tugas tidak dapat lagi diambil. Anda dapat menggunakan metode berikut untuk segera mendapatkan informasi tugas:

    Coba sekarang

    Coba API ini di OpenAPI Explorer tanpa perlu penandatanganan manual. Panggilan yang berhasil akan secara otomatis menghasilkan contoh kode SDK sesuai dengan parameter Anda. Unduh kode tersebut dengan kredensial bawaan yang aman untuk penggunaan lokal.

    Test

    RAM authorization

    Tabel berikut menjelaskan otorisasi yang diperlukan untuk memanggil API ini. Anda dapat menentukannya dalam kebijakan Resource Access Management (RAM). Kolom pada tabel dijelaskan sebagai berikut:

    • Action: Aksi yang dapat digunakan dalam elemen Action pada pernyataan kebijakan izin RAM untuk memberikan izin guna melakukan operasi tersebut.

    • API: API yang dapat Anda panggil untuk melakukan aksi tersebut.

    • Access level: Tingkat akses yang telah ditentukan untuk setiap API. Nilai yang valid: create, list, get, update, dan delete.

    • Resource type: Jenis resource yang mendukung otorisasi untuk melakukan aksi tersebut. Ini menunjukkan apakah aksi tersebut mendukung izin tingkat resource. Resource yang ditentukan harus kompatibel dengan aksi tersebut. Jika tidak, kebijakan tersebut tidak akan berlaku.

      • Untuk API dengan izin tingkat resource, jenis resource yang diperlukan ditandai dengan tanda bintang (*). Tentukan Nama Sumber Daya Alibaba Cloud (ARN) yang sesuai dalam elemen Resource pada kebijakan.

      • Untuk API tanpa izin tingkat resource, ditampilkan sebagai All Resources. Gunakan tanda bintang (*) dalam elemen Resource pada kebijakan.

    • Condition key: Kunci kondisi yang didefinisikan oleh layanan. Kunci ini memungkinkan kontrol granular, berlaku baik hanya untuk aksi maupun untuk aksi yang terkait dengan resource tertentu. Selain kunci kondisi spesifik layanan, Alibaba Cloud menyediakan serangkaian common condition keys yang berlaku di semua layanan yang didukung RAM.

    • Dependent action: Aksi dependen yang diperlukan untuk menjalankan aksi tersebut. Untuk menyelesaikan aksi tersebut, pengguna RAM atau role RAM harus memiliki izin untuk melakukan semua aksi dependen.

    Action

    Access level

    Resource type

    Condition key

    Dependent action

    imm:CreateOfficeConversionTask

    create

    *Project

    acs:imm:{#regionId}:{#accountId}:project/{#ProjectName}

    		 None None

    Parameter permintaan

    Parameter

    Type

    Required

    Description

    Example
    ProjectName

    string

    Yes

    Nama proyek. Untuk informasi tentang cara mendapatkan nama proyek, lihat Membuat proyek.

    test-project
    SourceURI

    string

    No

    Alamat penyimpanan data sumber.

    Alamat OSS mengikuti format oss://${Bucket}/${Object}, di mana ${Bucket} adalah nama bucket OSS di region yang sama dengan proyek saat ini, dan ${Object} adalah path lengkap file termasuk ekstensi nama file.

    oss://test-bucket/test-object
    Sources

    array<object>

    No

    Daftar gambar input. Urutan konversi mengikuti urutan URI dalam daftar input. (Parameter ini belum dirilis secara resmi dan tidak direkomendasikan.).

    oss://imm-test/test.pptx

    object

    No

    Informasi gambar input.

    URI

    string

    No

    Alamat OSS gambar sumber.

    Alamat OSS mengikuti format oss://${Bucket}/${Object}, di mana ${Bucket} adalah nama bucket OSS di region yang sama dengan proyek saat ini, dan ${Object} adalah path lengkap file termasuk ekstensi nama file.

    Format gambar yang didukung: jpg, jp2, png, tiff, webp, bmp, dan svg.

    oss://examplebucket/sampleobject.jpg
    Rotate

    integer

    No

    Sudut rotasi gambar. Nilai yang valid:

    • 0 (default)

    • 90

    • 180

    90
    TargetURI

    string

    No

    Template URI output untuk konversi dokumen.

    Alamat mengikuti format oss://{bucket}/{tags.custom}/{dirname}/{barename}.{autoext}. Untuk informasi selengkapnya, lihat Template TargetURI.

    Catatan

    Anda harus menentukan setidaknya salah satu dari TargetURI dan TargetURIPrefix.

    oss://examplebucket/outputDocument.pdf
    TargetURIPrefix

    string

    No

    Prefiks alamat penyimpanan untuk file output setelah konversi dokumen.

    Formatnya adalah oss://${Bucket}/${Prefix}/, di mana ${Bucket} adalah nama bucket OSS di region yang sama dengan proyek saat ini, dan ${Prefix} adalah prefiks alamat penyimpanan untuk file output.

    Catatan

    Anda harus menentukan setidaknya salah satu dari TargetURI dan TargetURIPrefix. .

    oss://examplebucket/outputprefix/
    SourceType

    string

    No

    Jenis sufiks data sumber. Secara default, jenis data sumber ditentukan oleh sufiks objek OSS. Jika objek OSS tidak memiliki sufiks, Anda dapat mengatur parameter ini. Nilai yang valid:

    • Dokumen Word: doc, docx, wps, wpss, docm, dotm, dot, dan dotx

    • Dokumen PowerPoint: pptx, ppt, pot, potx, pps, ppsx, dps, dpt, pptm, potm, ppsm, dan dpss

    • Dokumen Excel: xls, xlt, et, ett, xlsx, xltx, csv, xlsb, xlsm, xltm, dan ets

    • Dokumen PDF: pdf.

    doc
    TargetType

    string

    Yes

    Jenis file target untuk output konversi. Nilai yang valid:

    • png: mengonversi dokumen menjadi file gambar PNG.

    • jpg: mengonversi dokumen menjadi file gambar JPG.

    • pdf: mengonversi dokumen menjadi file PDF.

    • txt: mengonversi dokumen menjadi file teks saja, yang terutama digunakan untuk mengekstrak konten teks dari dokumen. Hanya dokumen PowerPoint, Word, dan Excel yang didukung sebagai jenis data sumber. Ketika dokumen Excel dikonversi, satu file txt dihasilkan, dan pengaturan variabel terkait sheet tidak berlaku.

    png
    UserData

    string

    No

    Data pengguna kustom, yang dikembalikan dalam notifikasi pesan asinkron. Anda dapat menggunakan parameter ini untuk mengaitkan notifikasi pesan dengan sistem internal Anda. Panjang maksimum adalah 2.048 byte.

    { "id": "test-id", "name": "test-name" }
    Tags

    object

    No

    Informasi tag kustom dalam format kamus. Digunakan untuk mencari tugas.

    { "key": "value" }
    StartPage

    integer

    No

    Halaman awal untuk konversi dokumen. Nilai default: 1.

    Catatan

    • Jika file sumber adalah dokumen Excel, Anda harus menentukan nomor halaman worksheet.

    • Parameter ini hanya berlaku saat mengonversi ke gambar. Parameter ini tidak berlaku saat mengonversi ke PDF atau txt.

    1
    EndPage

    integer

    No

    Halaman akhir untuk konversi dokumen. Nilai default: -1, yang menunjukkan bahwa konversi dimulai dari halaman awal dan berakhir di halaman terakhir.

    Catatan

    • Jika file sumber adalah dokumen Excel, Anda harus menentukan nomor halaman worksheet (SheetIndex).

    • Jika dokumen memiliki banyak halaman, konversi secara bertahap untuk menghindari waktu tunggu konversi habis.

    • Parameter ini hanya berlaku saat mengonversi ke gambar. Parameter ini tidak berlaku saat mengonversi ke PDF atau txt.

    -1
    Password

    string

    No

    Kata sandi untuk membuka dokumen. Atur parameter ini jika Anda perlu mengonversi dokumen yang dilindungi kata sandi.

    123456
    ScalePercentage

    integer

    No

    Persentase penskalaan dokumen. Nilai yang valid: 20 hingga 199. Nilai default: 100, yang menunjukkan tanpa penskalaan.

    Catatan

    Nilai kurang dari 100 menunjukkan perkecilan, dan nilai lebih dari 100 menunjukkan pembesaran.

    100
    Quality

    integer

    No

    Kualitas file yang dikonversi. Nilai yang valid: 0 (kualitas terendah, performa terbaik) hingga 100 (kualitas tertinggi, performa terendah). Secara default, sistem menyeimbangkan kualitas dan performa berdasarkan konten dokumen dan menetapkan nilai yang sesuai.

    60
    Pages

    string

    No

    Nomor halaman yang akan dikonversi. Parameter ini memiliki prioritas lebih tinggi dari StartPage dan EndPage. Format:

    • Pisahkan beberapa nomor halaman dengan koma (,), seperti 1,2.

    • Gunakan tanda hubung (-) untuk nomor halaman berurutan, seperti 1,2-4,7.

    1,2-4,7
    MaxSheetRow

    integer

    No

    Jumlah maksimum baris yang akan dikonversi saat mengonversi dokumen Excel ke gambar. Secara default, semua baris dikonversi.

    Catatan

    Parameter ini hanya berlaku ketika LongPicture diatur ke true.

    10
    MaxSheetColumn

    integer

    No

    Jumlah maksimum kolom yang akan dikonversi saat mengonversi dokumen Excel ke gambar. Secara default, semua kolom dikonversi.

    Catatan

    Parameter ini hanya berlaku ketika LongPicture diatur ke true.

    10
    SheetCount

    integer

    No

    Jumlah worksheet (sheet) yang akan dikonversi menjadi gambar dalam dokumen Excel. Secara default, semua worksheet dikonversi.

    1
    SheetIndex

    integer

    No

    Nomor halaman worksheet (sheet) yang akan dikonversi menjadi gambar dalam dokumen Excel. Nilai yang valid: 1 hingga halaman sheet terakhir. Nilai default: 1.

    1
    FitToWidth

    boolean

    No

    Menentukan apakah akan menampilkan semua kolom ke satu gambar atau halaman PDF saat mengonversi dokumen Excel ke gambar atau file PDF. Nilai yang valid:

    • false (default): menampilkan beberapa gambar atau halaman PDF.

    • true: menampilkan satu gambar atau halaman PDF.

    false
    FitToHeight

    boolean

    No

    Menentukan apakah akan menampilkan semua baris ke satu gambar atau halaman PDF saat mengonversi dokumen Excel ke gambar atau file PDF. Nilai yang valid:

    • false (default): menampilkan beberapa gambar atau halaman PDF.

    • true: menampilkan satu gambar atau halaman PDF.

    false
    FirstPage

    boolean

    No

    Menentukan apakah hanya mengembalikan gambar pertama dari hasil konversi saat mengonversi dokumen Excel ke gambar. Jumlah baris dan kolom yang termasuk dalam gambar ditentukan oleh pemisahan otomatis. Nilai yang valid:

    • false (default): mengembalikan semua gambar.

    • true: hanya mengembalikan gambar pertama (mengekstrak thumbnail).

    Catatan

    Parameter ini hanya berlaku ketika LongPicture diatur ke true.

    false
    PaperSize

    string

    No

    Ukuran kertas untuk mengonversi dokumen Excel ke gambar. Gambar output dapat dibandingkan dengan pencetakan di kertas. Nilai yang valid:

    • A0

    • A2

    • A4 (default)

    Catatan

    Parameter ini hanya berlaku saat digunakan bersama FitToHeight dan FitToWidth.

    A4
    PaperHorizontal

    boolean

    No

    Menentukan apakah akan menempatkan kertas secara horizontal saat mengonversi dokumen Excel ke gambar. Gambar output dapat dibandingkan dengan pencetakan di kertas. Nilai yang valid:

    • false (default): menempatkan kertas secara vertikal.

    • true: menempatkan kertas secara horizontal.

    false
    TrimPolicy TrimPolicy

    No

    Kebijakan pemangkasan untuk konversi dokumen Excel. Misalnya, jika spreadsheet berisi banyak baris dan kolom kosong, output mungkin berisi ruang kosong yang berlebihan tanpa kebijakan pemangkasan.

    ShowComments

    boolean

    No

    Menentukan apakah akan menampilkan komentar saat mengonversi dokumen Word ke gambar. Nilai yang valid:

    • false (default): tidak menampilkan komentar.

    • true: menampilkan komentar.

    false
    LongPicture

    boolean

    No

    Menentukan apakah akan mengonversi dokumen menjadi satu gambar panjang. Nilai yang valid:

    • false (default): mengonversi menjadi beberapa gambar.

    • true: mengonversi menjadi satu gambar panjang.

    Catatan

    Maksimum 20 halaman dapat digabungkan menjadi satu gambar panjang. Tugas konversi yang melebihi batas halaman ini mungkin gagal.

    false
    ImageDPI

    integer

    No

    DPI gambar output. Nilai yang valid: 96 hingga 600. Nilai default: 96.

    96
    LongText

    boolean

    No

    Menentukan apakah akan mengonversi dokumen menjadi satu file teks panjang. Nilai yang valid:

    • false (default): mengonversi setiap halaman menjadi file teks independen.

    • true: menggabungkan semua konten menjadi satu file teks.

    false
    HoldLineFeed

    boolean

    No

    Menentukan apakah akan mempertahankan jeda baris dalam dokumen saat mengonversi ke teks. Nilai yang valid:

    • false (default): tidak mempertahankan jeda baris.

    • true: mempertahankan jeda baris.

    false
    CredentialConfig CredentialConfig

    No

    Biarkan parameter ini kosong kecuali Anda memiliki persyaratan khusus.

    Konfigurasi otorisasi China. Parameter ini bersifat opsional. Untuk informasi selengkapnya, lihat Menggunakan otorisasi berantai untuk mengakses sumber daya entitas lain.

    Notification Notification

    No

    Konfigurasi notifikasi pesan. Klik Notification untuk detailnya. Untuk informasi selengkapnya tentang format pesan notifikasi asinkron, lihat Format pesan notifikasi asinkron.

    Elemen respons

    Element

    Type

    Description

    Example

    object

    Respons tugas asinkron.

    RequestId

    string

    ID permintaan.

    FF3B7D81-66AE-47E0-BF69-157DCF18*****
    TaskId

    string

    ID tugas.

    formatconvert-00bec802-073a-4b61-ba3b-39bc2fdd*****
    EventId

    string

    ID peristiwa.

    2C2-1I0EG57VR37J4rQ8oKG6C9*****

    Contoh

    Respons sukses

    JSONformat

    {
  "RequestId": "FF3B7D81-66AE-47E0-BF69-157DCF18*****",
  "TaskId": "formatconvert-00bec802-073a-4b61-ba3b-39bc2fdd*****",
  "EventId": "2C2-1I0EG57VR37J4rQ8oKG6C9*****"
}

    Kode kesalahan

    Lihat Error Codes untuk daftar lengkap.

    Catatan rilis

    Lihat Release Notes untuk daftar lengkap.