Pemasangan

Paketnya adalah tersedia di pypi.org dan dapat diinstal melalui pip dengan menjalankan perintah berikut:

pip install groupdocs-translation-cloud

Python SDK untuk Menerjemahkan Dokumen Cloud

GroupDocs.Translation Cloud adalah Cloud API untuk menerjemahkan Word (termasuk file RTF dan TXT), Excel (termasuk file CSV / TSV), PowerPoint, PDF, HTML, Markdown (termasuk Markdown dengan sintaks Hugo), OpenDocument, RESX, file SRT, gambar format JPG, PNG, SVG, BMP dan GIF serta PDF yang dipindai serta teks biasa.

Demi kenyamanan pelanggan Python kami, kami memperkenalkan SDK sederhana yang membantu menambahkan terjemahan semua format file dokumen dan gambar yang disebutkan di atas dan teks biasa ke aplikasi Anda hanya dengan beberapa baris kode.

Secara detail, ini adalah seperangkat SDK untuk terjemahan dokumen dan teks biasa di Cloud kami. Mendukung terjemahan .doc, .docx, .docm, .xls, .xlsx, .xlsm, .ppt, .pptx, .pptm, .pdf, .html, .md, .odt, .ods, .odp, .csv, .tsv, .rtf, .txt, .resx, .srt, .png, File .jpg, .svg, .bmp dan .gif. Cukup kirimkan file atau teks tertentu ke GroupDocs.Translation Cloud API, dan itu akan menerjemahkan dan menyimpan file yang diterjemahkan di S3 atau akan mengembalikan teks yang diterjemahkan.

Sangat mudah untuk memulai dengan GroupDocs.Translation Cloud dan tidak perlu menginstal apa pun. Buat akun di GroupDocs Cloud dan dapatkan informasi aplikasi Anda, lalu Anda siap menggunakan SDK.

Fitur Terjemahan Dokumen Cloud

• Terjemahan dokumen Microsoft Word®, Microsoft Excel®, dan Microsoft PowerPoint® -46 languages and 140 languages pairs support- Penerjemahan tabel, header, footer, catatan kaki/catatan akhir, keterangan gambar pada dokumen Word dan file ODT
• Terjemahan sel, bagan, tabel, tabel pivot dalam dokumen Excel dan file ODS
• Terjemahan bingkai teks, tabel, header, footer, bagan, komentar dalam presentasi PowerPoint dan file ODP
• Terjemahan file PDF
• Terjemahan file penurunan harga
• Terjemahan sintaks Hugo dalam file Markdown
• Terjemahan teks biasa
• Terjemahan sumber daya .NET dalam format RESX
• Terjemahan subtitle dalam format SRT
• Terjemahan gambar dan PDF yang dipindai mendapatkan teks biasa atau PDF sebagai hasilnya
• Terjemahan tabel yang dipindai untuk mendapatkan buku kerja Excel sebagai hasilnya
• Terjemahan teks tulisan tangan

Format Terjemahan yang Didukung

Anda harus menentukan format dokumen yang akan diterjemahkan dengan memasukkan nilai enum yang sesuai ke dalam isi permintaan.

Selain itu, pengguna dapat memperoleh file terjemahan dalam format lain yang tersedia untuk konversi. Cukup tentukan format keluaran dokumen yang diterjemahkan dengan meletakkan ekstensi file di badan permintaan:

• doc, docx, odt, rtf — docx, rtf, html, odt, txt, md, pdf, tiff, svg, xps
• xls, xlsx, ods, csv, tsv — xlsx, xlsb, html, pdf, xps, ods, md, docx, pptx, tiff
• ppt, pptx, odp — pptx, pdf, tiff, html, xps, odp
• pdf — docx, pptx, html, svg, xps
• md — html, pdf, docx, tiff, xps
• html — md, pdf, docx, tiff, xps

Silakan kunjungi Supported Formats untuk detailnya.

Bahasa Terjemahan yang Didukung

• en-fr / fr-en — to translate from English to French or from French to English.
• en-de / de-en — to translate from English to German or from German to English.
• en-es / es-en — to translate from English to Spanish or from Spanish to English.
• en-it / it-en — to translate from English to Italian or from Italian to English.
• en-zh / zh-en — to translate from English to Chinese or from Chinese to English.
• en-ru / ru-en — to translate from English to Russian or from Russian to English
• en-ar / ar-en — to translate from English to Arabic or from Arabic to English
• en-pt / pt-en — to translate from English to Portuguese or from Portuguese to English
• en-pl / pl-en — to translate from English to Polish or from Polish to English
• en-uk / uk-en — to translate from English to Ukrainian or from Ukrainian to English
• en-vi / vi-en — to translate from English to Vietnamese or from Vietnamese to English
• en-id / id-en — to translate from English to Indonesian or from Indonesian to English
• en-hi / hi-en — to translate from English to Hindi or from Hindi to English
• en-el / el-en — to translate from English to Greek or from Greek to English
• en-nl / nl-en— to translate from English to Dutch or from Dutch to English
• en-hu / hu-en — to translate from English to Hunngarian or from Hungarian to English
• en-sv / sv-en — to translate from English to Swedish or from Swedish to English
• en-tr / tr-en — to translate from English to Turkish or from Turkish to English
• en-ja / ja-en — to translate from English to Japanese or from Japanese to English
• en-ko / ko-en — to translate from English to Korean or from Korean to English
• en-cs / cs-en — to translate from English to Czech or from Czech to English
• en-fi / fi-en — to translate from English to Finnish or from Finnish to English
• en-ga / ga-en — to translate from English to Irish or from Irish to English
• en-fa / fa-en — to translate from English to Farsi or from Farsi to English
• en-az / az-en — to translate from English to Azerbaijani or from Azerbaijani to English
• en-he / he-en — to translate from English to Hebrew or from Hebrew to English
• en-sk / sk-en — to translate from English to Slovak or from Slovak to English
• en-th / th-en — to translate from English to Thai or from Thai to English
• en-ro / ro-en — to translate from English to Romanian or from Romanian to English
• en-ms / ms-en — to translate from English to Malay or from Malay to English
• en-bg / bg-en — to translate from English to Bulgarian or from Bulgarian to English
• en-bn / bn-en — to translate from English to Bengali or from Bengali to English
• en-da / da-en — to translate from English to Danish or from Danish to English
• en-lt / lt-en — to translate from English to Lithuanian or from Lithuanian to English
• en-lv / lv-en — to translate from English to Latvian or from Latvian to English
• en-no / no-en — to translate from English to Norwegian or from Norwegian to English
• en-et / et-en — to translate from English to Estonian or from Estonian to English
• en-hy / hy-en — to translate from English to Armenian or from Armenian to English
• en-ca / ca-en — to translate from English to Catalan or from Catalan to English
• en-hr / hr-en — to translate from English to Croatian or from Croatian to English
• en-sr / sr-en — to translate from English to Serbian or from Serbian to English
• en-af / af-en — to translate from English to Afrikaans or from Afrikaans to English
• en-ur / ur-en — to translate from English to Urdu or from Urdu to English
• en-tl / tl-en — to translate from English to Tagalog or from Tagalog to English
• en-ka / ka-en — to translate from English to Georgian or from Georgian to English
• fr-de / de-fr — to translate from French to German or from German to French
• fr-it / it-fr — to translate from French to Italian or from Italian to French
• fr-ar / ar-fr — to translate from French to Arabic or from Arabic to French
• fr-es / es-fr — to translate from French to Spanish or from Spanish to French
• fr-id / id-fr — to translate from French to Indonesian or from Indonesian to French
• fr-ms / ms-fr — to translate from French to Malay or from Malay to French
• fr-pl / pl-fr — to translate from French to Polish or from Polish to French
• fr-ru / ru-fr — to translate from French to Russian or from Russian to French
• fr-ar / ar-fr — to translate from French to Arabic or from Arabic to French
• de-it / it-de — to translate from German to Italian or from Italian to German
• de-pl / pl-de — to translate from German to Polish or from Polish to German
• de-ar / ar-de — to translate from German to Arabic or from Arabic to German
• de-zh / zh-de — to translate from German to Chinese or from Chinese to German
• de-es / es-de — to translate from German to Spanish or from Spanish to German
• de-ms / ms-de — to translate from German to Malay or from Malay to German
• de-uk / uk-de — to translate from German to Ukrainian or from Ukrainian to German
• it-es / es-it — to translate from Italian to Spanish or from Spanish to Italian
• it-ar / ar-it — to translate from Italian to Arabic or from Arabic to Italian
• it-uk / uk-it — to translate from Italian to Ukrainian or from Ukrainian to Italian
• it-ms / ms-it — to translate from Italian to Malay or from Malay to Italian
• sv-zh / zh-sv — to translate from Swedish to Chinese or from Chinese to Swedish
• ar-es / es-ar — to translate from Arabic to Spanish or from Spaish to Arabic
• ar-tr / tr-ar — to translate from Arabic to Turkish or from Turkish to Arabic
• ar-pl / pl-ar — to translate from Arabic to Polish or from Polish to Arabic
• ru-es / es-ru — to translate from Russian to Spanish or from Spaish to Russian

Detail Permintaan JSON

Anda dapat memasukkan informasi berikut di badan permintaan untuk menerjemahkan dokumen:

• format — format file untuk terjemahan
• outputFormat — format file yang diterjemahkan (misalnya pdf)
• sourceLanguage — bahasa dokumen asli (misalnya en)
• targetLanguages — bahasa terjemahan sebagai daftar (misalnya [fr, de])
• file — file yang akan diterjemahkan dalam bentuk array byte
• url — tautan ke file yang akan diterjemahkan, baik file atau url harus disediakan
• originalFileName — nama asli file yang akan diterjemahkan, jika id permintaan nol atau kosong akan digunakan
• master — jika slide master harus diterjemahkan (hanya untuk presentasi, sampaikan benar atau salah)
• elemen — geser halaman untuk diterjemahkan (hanya untuk presentasi, berikan daftar kosong untuk menerjemahkan seluruh presentasi)
• pemisah — pembatas untuk file CSV
• rentang - kamus rentang di buku kerja Excel
• shortcodedict — kamus sintaks kode pendek di Hugo untuk diterjemahkan, dengan kuncinya adalah indeks kode pendek berbasis nol, dan nilai adalah daftar nama parameter yang memerlukan terjemahan
• frontmatterdict — kamus sintaksis materi depan di Hugo untuk menerjemahkan, dengan kuncinya adalah indeks materi depan berbasis nol dan nilai adalah daftar jalur ke nilai yang memerlukan terjemahan, setiap jalur juga merupakan daftar.

Untuk menerjemahkan teks biasa, informasi berikut harus dimasukkan ke dalam isi permintaan:

• sourceLanguage — bahasa teks asli (misalnya en)
• targetLanguages — bahasa terjemahan sebagai daftar (misalnya [fr, de])
• teks — daftar teks yang akan diterjemahkan (misalnya [halo dunia])
• contains-markdown — benar jika teks berisi sintaksis penurunan harga

Bagaimana cara menggunakan SDK?

API kami sepenuhnya independen dari sistem operasi, sistem basis data, atau bahasa pengembangan Anda. Anda dapat menggunakan bahasa dan platform apa pun yang mendukung HTTP untuk berinteraksi dengan API kami. Namun, menulis kode klien secara manual bisa jadi sulit, rawan kesalahan, dan memakan waktu. Oleh karena itu, kami telah memberikan dan mendukung SDKs dalam banyak bahasa pengembangan untuk memudahkan Cloud Apps Anda berintegrasi dengan kami.

Mulai cepat

1. Dapatkan kunci API jika belum

Buat akun pribadi di GroupDocs Cloud Dashboard dan klik Dapatkan Kunci. Kunci ini berguna untuk semua produk GroupDocs Cloud. Jika Anda mempunyai masalah, lihat ini detailed manual. Setelah kunci Anda diterima, silakan ikuti ini article untuk mencoba GroupDocs.Translation Cloud atau membiasakannya Developer guide untuk rincian lebih lanjut.

2. Instal SDK

Memasang groupdocs-translation-cloud dengan PIP dari PyPI by:

pip install groupdocs-translation-cloud

Atau kloning repositori dan instal melalui Setuptools:

python setup.py install

3. Jalankan Demo

• Periksa SDK atau dapatkan dari PiPy
  • Tetapkan klien_id & klien_rahasia Anda
  • Jalankan Buku Catatan Jupyter demo.ipynb

Struktur

Proyek ini meliputi:

• Modul “groupdocstranslationcloud”, ini SDK. Anda dapat mengintegrasikannya ke dalam aplikasi Anda. Ini berisi API Terjemahan dan Penyimpanan
• Modul “tes”, unittests. Anda dapat melihatnya untuk melihat berbagai contoh kode.
• Buku catatan Jupyter “demo”. Contoh buku catatan demo.

Ketergantungan

• Lihat persyaratan.txt

Dukungan versi

Python :: 2.7 , Python :: 3, Python :: 3.4, Python :: 3.5, Python :: 3.6, Python :: 3.7, Python :: 3.8

Terjemahkan teks biasa

# Load the gem
import groupdocs_translation_cloud
# Get Client Id and Client Secret from https://dashboard.groupdocs.cloud
my_client_id = ""
my_client_secret = ""

# Create instance of the API
configuration = Configuration(apiKey=my_client_secret, appSid=my_client_id)
api = TranslationApi(configuration)

#document translation
pair = "en-fr"
_format = "docx"
storage = "First Storage"
name = "test.docx"
folder = ""
savepath = ""
savefile = "test_python.docx"  
masters = False
elements = []
translator = TranslateDocument(pair, _format, storage, name, folder, savepath, savefile, masters, elements)
request = translator.to_string()
res_doc = api.post_translate_document(request)
print(res_doc.message)

Dokumentasi untuk Titik Akhir API

Semua URI bersifat relatif terhadap https://api.groupdocs.cloud/v2.0/translation

Kelas |         | Metode | Permintaan HTTP | Deskripsi ———— |-| ————- | ————- | ————-TranslationApi |         |autoPost| POS/auto | Terjemahkan file apa pun yang didukungTranslationApi|         |csvPost| POS/csv | Terjemahkan file CSV dan TSVTranslationApi|         |documentPost| POS/document | Terjemahkan dokumen Microsoft Word, rtf, txt, odtTranslationApi|         |documentRequestIdGet| MENDAPATKAN/document/{requestId}| Kembalikan status terjemahan dokumen. Juga kembalikan URL untuk mengunduh dokumen yang diterjemahkan jika terjemahan berhasil TranslationApi|         |documentTrialPost| POS/document/trial | Uji coba menerjemahkan dokumen Microsoft Word, rtf, txt, odt tanpa percakapan. Terjemahkan hanya halaman pertama atau 1000 simbol.TranslationApi|         |hcGet| MENDAPATKAN/hc | Pemeriksaan kesehatan untuk semua layanan.TranslationApi|         |htmlPost| POS/html | Terjemahkan file HTMLTranslationApi|         |hugoGet| MENDAPATKAN/hugo | Dapatkan struktur sintaksis Hugo dari file penurunan hargaTranslationApi|         |hugoPost| POS/hugo | Jalankan analisis struktur sintaksis Hugo dari file penurunan hargaTranslationApi|         |imageToFilePost| POS/image-to-file | Terjemahkan gambar atau pindaian pdf dan kembalikan fileTranslationApi|         |imageToTextPost| POS/image-to-text | Terjemahkan teks pada gambar atau pindaian pdfTranslationApi|         |languagesGet| MENDAPATKAN/languages | Kembalikan daftar pasangan bahasa yang tersediaTranslationApi|         |markdownPost| POS/markdown | Terjemahkan file penurunan hargaTranslationApi|         |pdfPost| POS/pdf | Terjemahkan file pdfTranslationApi|         |pdfTrialPost| POS/pdf/trial | Terjemahan pdf percobaan. Terjemahkan hanya halaman pertama tanpa konversi ke format lain.TranslationApi|         |presentationPost| POS/presentation | Terjemahkan presentasi Microsoft PowerPoint, odpTranslationApi|         |resxPost| POS/resx | Terjemahkan file RESXTranslationApi|         |spreadsheetPost| POS/spreadsheet | Terjemahkan buku kerja Microsoft Excel, odsTranslationApi|         |textPost| POS/text | Terjemahkan teksTranslationApi|         |textRequestIdGet| MENDAPATKAN/text/{requestId}| Kembalikan status terjemahan teks. Juga kembalikan teks terjemahan jika terjemahan berhasil TranslationApi|         |textTrialPost| POS/text/trial| Uji coba menerjemahkan teks. Terjemahkan hanya 1000 simbol.

Dokumentasi untuk Model

CloudFileResponse , CloudHugoResponse, CloudTextResponse, CsvFileRequest, FileRequest, HealthCheckStatus, HtmlFileRequest, HttpStatusCode, HugoRequest, ImageToFileRequest, ImageToTextRequest, LanguagePairData, MarkdownFileRequest, PdfFileRequest, PresentationFileRequest, ResxFileRequest, SpreadsheetFileRequest, StatusResponse, StringStringTuple, TextDocumentFileRequest, TextRequest, UrlFileInfo, WorksheetData

GroupDocs.Translasi Cloud SKD

Github

Manajer Paket