पायथन का उपयोग करके वर्ड फाइल्स को एनोटेट करें

पायथन डेवलपर के रूप में, आप क्लाउड पर किसी भी वर्ड (.doc या .docx) फ़ाइल को प्रोग्रामेटिक रूप से एनोटेट कर सकते हैं। एनोटेशन आमतौर पर डेटा के मौजूदा टुकड़े के बारे में अतिरिक्त जानकारी प्रदान करने वाले दस्तावेज़ में टिप्पणियों, नोट्स, स्पष्टीकरण या अन्य प्रकार की बाहरी टिप्पणियों के रूप में मेटाडेटा होते हैं। यह लेख इस बात पर ध्यान केंद्रित करेगा कि पायथन में REST API का उपयोग करके DOCX फ़ाइलों को कैसे एनोटेट किया जाए।

इस लेख में निम्नलिखित विषयों को शामिल किया जाएगा:

• दस्तावेज़ एनोटेशन REST API और पायथन SDK
• REST API का उपयोग करके DOCX फ़ाइलों को एनोटेट करें
• पायथन का उपयोग करके एकाधिक एनोटेशन जोड़ें

दस्तावेज़ एनोटेशन REST API और पायथन SDK

DOC या DOCX दस्तावेजों की व्याख्या करने के लिए, मैं Python SDK of GroupDocs.Annotation Cloud API का उपयोग करूंगा। यह आपको प्रोग्रामेटिक रूप से ऑनलाइन दस्तावेज़ और छवि एनोटेशन टूल बनाने की अनुमति देता है। इस तरह के उपकरणों का उपयोग सभी लोकप्रिय स्वरूपों के व्यावसायिक दस्तावेज़ों में एनोटेशन, वॉटरमार्क ओवरले, टेक्स्ट रिप्लेसमेंट, रिडक्शन, स्टिकी नोट्स और टेक्स्ट मार्कअप जोड़ने के लिए किया जा सकता है। यह क्लाउड एपीआई के लिए अपने दस्तावेज़ एनोटेशन परिवार के सदस्यों के रूप में .NET, Java, PHP, Ruby और Node.js SDK भी प्रदान करता है।

आप कंसोल में निम्न आदेश का उपयोग करके GroupDocs.Annotation Cloud को अपने Python प्रोजेक्ट में इंस्टॉल कर सकते हैं:

pip install groupdocs_annotation_cloud

चरणों और उपलब्ध कोड उदाहरणों का पालन शुरू करने से पहले कृपया डैशबोर्ड से अपनी क्लाइंट आईडी और क्लाइंट सीक्रेट प्राप्त करें। कोड में अपना आईडी और रहस्य जोड़ें जैसा कि नीचे दिखाया गया है:

client_id = "112f0f38-9dae-42d5-b4fc-cc84ae644972"
client_secret = "16ad3fe0bdc39c910f57d2fd48a5d618"
my_storage = ""

configurations = groupdocs_annotation_cloud.Configuration(client_id, client_secret)
configurations.api_base_url = "https://api.groupdocs.cloud"

पायथन में REST API का उपयोग करके DOCX फ़ाइलों को एनोटेट करें

आप नीचे बताए गए सरल चरणों का पालन करके DOCX फ़ाइल में एनोटेशन जोड़ सकते हैं:

• अपलोड क्लाउड पर DOCX फ़ाइल
• पायथन में DOCX फ़ाइलों में एनोटेशन जोड़ें
• डाउनलोड अद्यतन फ़ाइल

दस्तावेज़ अपलोड करें

सबसे पहले, नीचे दिए गए कोड उदाहरण का उपयोग करके DOCX फ़ाइल को क्लाउड पर अपलोड करें:

# एपीआई का उदाहरण बनाएँ
file_api = groupdocs_annotation_cloud.FileApi.from_config(configurations)

request = groupdocs_annotation_cloud.UploadFileRequest("one-page.docx", "C:\\Files\\one-page.docx", my_storage)
response = file_api.upload_file(request)

परिणामस्वरूप, अपलोड की गई DOCX फ़ाइल क्लाउड पर आपके डैशबोर्ड के फ़ाइल अनुभाग में उपलब्ध होगी।

पायथन में DOCX फ़ाइलों में एनोटेशन जोड़ें

Word दस्तावेज़ में प्रोग्रामेटिक रूप से एनोटेशन सम्मिलित करने के लिए कृपया नीचे दिए गए चरणों का पालन करें।

• एनोटेशनइन्फो का एक उदाहरण बनाएँ
• विभिन्न एनोटेशन गुण सेट करें जैसे स्थिति, प्रकार, टेक्स्ट इत्यादि।
• एक FileInfo उदाहरण बनाएँ
• फ़ाइल पथ सेट करें
• AnnotateOptions का एक उदाहरण बनाएँ
• फ़ाइल जानकारी को AnnotateOptions पर सेट करें
• एनोटेशन को एनोटेटऑप्शन पर सेट करें
• AnnotateRequest पद्धति को कॉल करके एक अनुरोध बनाएँ
• एनोटेटएपी .एनोटेट () विधि को कॉल करके परिणाम प्राप्त करें

निम्न कोड स्निपेट दिखाता है कि REST API का उपयोग करके Word दस्तावेज़ में क्षेत्र एनोटेशन कैसे सम्मिलित करें।

api = groupdocs_annotation_cloud.AnnotateApi.from_keys(client_id, client_secret)

a1 = groupdocs_annotation_cloud.AnnotationInfo()
a1.annotation_position = groupdocs_annotation_cloud.Point()
a1.annotation_position.x = 1
a1.annotation_position.y = 1
a1.box = groupdocs_annotation_cloud.Rectangle()
a1.box.x = 100
a1.box.y = 100
a1.box.width = 200
a1.box.height = 100
a1.page_number = 0
a1.pen_color = 1201033
a1.pen_style = "Solid"
a1.pen_width = 1
a1.opacity = 0.7

# क्षेत्र एनोटेशन जोड़ें
a1.type = "Area"
a1.text = "This is area annotation"
a1.creator_name = "Anonym A."

file_info = groupdocs_annotation_cloud.FileInfo()
file_info.file_path = "one-page.docx"
options = groupdocs_annotation_cloud.AnnotateOptions()
options.file_info = file_info
options.annotations = [a1]
options.output_path = "Output\\output.docx"

request = groupdocs_annotation_cloud.AnnotateRequest(options)
result = api.annotate(request)

नतीजतन, नीचे दिखाए गए दस्तावेज़ में क्षेत्र एनोटेशन डाला जाएगा।

समर्थित एनोटेशन प्रकार

कृपया समर्थित एनोटेशन प्रकारों की सूची नीचे देखें, आप पहले बताए गए चरणों का पालन करके अपनी DOCX फ़ाइलों में जोड़ सकते हैं:

• क्षेत्र
• दूरी
• जोड़ना
• बिंदु
• पॉलीलाइन
• छवि
• मूलपाठ
• वाटर-मार्क
• तीर

अद्यतन फ़ाइल डाउनलोड करें

उपरोक्त कोड नमूना एनोटेटेड DOCX फ़ाइल को क्लाउड पर सहेजेगा। आप निम्न कोड नमूने का उपयोग करके इसे डाउनलोड कर सकते हैं:

# एपीआई का उदाहरण बनाएँ
file_api = groupdocs_annotation_cloud.FileApi.from_config(configurations)

request = groupdocs_annotation_cloud.DownloadFileRequest("Output\\output.docx", my_storage)
response = file_api.download_file(request)

# डाउनलोड की गई फ़ाइल को अपनी कार्यशील निर्देशिका में ले जाएँ
shutil.move(response, "C:\\Files\\")

पायथन का उपयोग करके एकाधिक एनोटेशन जोड़ें

प्रोग्रामेटिक रूप से अपनी DOCX फ़ाइलों में एकाधिक एनोटेशन जोड़ने के लिए कृपया नीचे दिए गए चरणों का पालन करें।

• एनोटेशनइन्फो का पहला उदाहरण बनाएं
• पहले उदाहरण के लिए विभिन्न एनोटेशन गुण सेट करें जैसे स्थिति, प्रकार, टेक्स्ट इत्यादि।
• एनोटेशनइन्फो दूसरा उदाहरण बनाएं
• दूसरे उदाहरण के लिए विभिन्न एनोटेशन गुण सेट करें जैसे स्थिति, प्रकार, पाठ आदि।
• एक FileInfo उदाहरण बनाएँ
• फ़ाइल पथ सेट करें
• AnnotateOptions का एक उदाहरण बनाएँ
• फ़ाइल जानकारी को AnnotateOptions पर सेट करें
• पहले और दूसरे एनोटेशन को AnnotateOptions पर सेट करें
• AnnotateRequest पद्धति को कॉल करके एक अनुरोध बनाएँ
• एनोटेटएपी .एनोटेट () विधि को कॉल करके परिणाम प्राप्त करें

निम्न कोड स्निपेट दिखाता है कि REST API का उपयोग करके DOCX फ़ाइल में एकाधिक एनोटेशन कैसे जोड़ें। फ़ाइल अपलोड और डाउनलोड करने के लिए कृपया पहले बताए गए चरणों का पालन करें।

api = groupdocs_annotation_cloud.AnnotateApi.from_keys(client_id, client_secret)
  
a1 = groupdocs_annotation_cloud.AnnotationInfo()
a1.annotation_position = groupdocs_annotation_cloud.Point()
a1.annotation_position.x = 1
a1.annotation_position.y = 1
a1.box = groupdocs_annotation_cloud.Rectangle()
a1.box.x = 200
a1.box.y = 200
a1.box.width = 300
a1.box.height = 100
a1.page_number = 0
a1.pen_color = 1201033
a1.pen_style = "Solid"
a1.pen_width = 1
a1.opacity = 0.2
a1.type = "Watermark"
a1.text = "This is watermark annotation"
a1.creator_name = "Anonym A."
    
a2 = groupdocs_annotation_cloud.AnnotationInfo()
a2.annotation_position = groupdocs_annotation_cloud.Point()
a2.annotation_position.x = 852
a2.annotation_position.y = 59.38
a2.box = groupdocs_annotation_cloud.Rectangle()
a2.box.x = 375.8
a2.box.y = 59.38
a2.box.width = 88
a2.box.height = 37
a2.page_number = 2
a2.pen_color = 1201033
a2.pen_style = "Solid"
a2.pen_width = 1
a2.opacity = 0.9
a2.type = "Image"
a2.text = "This is Image annotation"
a2.creator_name = "Anonym A."
a2.image_path = "JohnSmith.png"
    
file_info = groupdocs_annotation_cloud.FileInfo()
file_info.file_path = "ten-pages.docx"
options = groupdocs_annotation_cloud.AnnotateOptions()
options.file_info = file_info
options.annotations = [a1, a2]
options.output_path = "Output\\output.docx"

request = groupdocs_annotation_cloud.AnnotateRequest(options)
result = api.annotate(request)

नतीजतन, छवि और वॉटरमार्क एनोटेशन दस्तावेज़ में डाले जाएंगे जैसा कि नीचे दिखाया गया है।

निष्कर्ष

इस लेख में, आपने सीखा है कि पायथन का उपयोग करके डॉक्यूमेंट एनोटेशन रेस्ट एपीआई के साथ क्लाउड पर वर्ड डॉक्यूमेंट में विभिन्न प्रकार के एनोटेशन कैसे जोड़े जाते हैं। आपने यह भी सीखा कि क्लाउड पर DOCX फ़ाइल को प्रोग्रामेटिक रूप से कैसे अपलोड किया जाए और फिर क्लाउड से एनोटेट की गई फ़ाइल को डाउनलोड किया जाए। आप दस्तावेज़ का उपयोग करके GroupDocs.Annotation Cloud API के बारे में अधिक जान सकते हैं। हम एक एपीआई संदर्भ अनुभाग भी प्रदान करते हैं जो आपको सीधे ब्राउज़र के माध्यम से हमारे एपीआई के साथ कल्पना और बातचीत करने देता है। किसी भी अस्पष्टता के मामले में, कृपया बेझिझक हमसे फोरम पर संपर्क करें।