PHP में REST API का उपयोग करके PDF दस्तावेज़ों की व्याख्या करें

एनोटेशन दस्तावेज़ के किसी विशिष्ट भाग के बारे में अतिरिक्त जानकारी प्रदान करते हैं। हम एनोटेशन का उपयोग करके दस्तावेज़ों को फीडबैक और समीक्षाओं के साथ चिह्नित कर सकते हैं। हम एनोटेशन के रूप में PDF दस्तावेज़ों में चित्र, टिप्पणियाँ, नोट्स या अन्य प्रकार की बाहरी टिप्पणियाँ जोड़ सकते हैं। इस लेख में, हम सीखेंगे कि PHP में REST API का उपयोग करके PDF दस्तावेज़ों की व्याख्या कैसे करें।

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

पीडीएफ एनोटेशन रेस्ट एपीआई और पीएचपी एसडीके

PDF दस्तावेज़ों की व्याख्या करने के लिए, हम GroupDocs.Annotation Cloud के PHP SDK API का उपयोग करेंगे। यह एनोटेशन, वॉटरमार्क ओवरले, टेक्स्ट रिप्लेसमेंट, रिडक्शन और टेक्स्ट मार्कअप को समर्थित दस्तावेज़ प्रारूप में जोड़ने की अनुमति देता है। कृपया कंसोल में निम्न आदेश का उपयोग करके इसे स्थापित करें:

composer require groupdocscloud/groupdocs-annotation-cloud

स्थापना के बाद, कृपया नीचे दिखाए गए एसडीके का उपयोग करने के लिए संगीतकार ऑटोलोड का उपयोग करें:

require_once('vendor/autoload.php');

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

// यह कोड उदाहरण दर्शाता है कि क्लाइंट आईडी और कोड में गुप्त कैसे जोड़ा जाए।
static $ClientId = '659fe7da-715b-4744-a0f7-cf469a392b73';
static $ClientSecret = 'b377c36cfa28fa69960ebac6b6e36421';

static $ApiBaseUrl = 'https://api.groupdocs.cloud';
static $MyStorage = '';

// कॉन्फ़िगरेशन को इनिशियलाइज़ करना
$configuration = new GroupDocs\Annotation\Configuration();

// कॉन्फ़िगरेशन सेट करना
$configuration->setAppSid(self::$ClientId);
$configuration->setAppKey(self::$ClientSecret);
$configuration->setApiBaseUrl(self::$ApiBaseUrl);

PHP में REST API का उपयोग करके PDF दस्तावेज़ों को एनोटेट करें

हम नीचे दिए गए सरल चरणों का पालन करके क्लाउड पर पीडीएफ दस्तावेज़ों की व्याख्या कर सकते हैं:

  1. अपलोड क्लाउड पर पीडीएफ फाइल
  2. एनोटेट पीडीएफ दस्तावेज़
  3. डाउनलोड एनोटेट फ़ाइल

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

सबसे पहले, हम निम्नलिखित कोड नमूने का उपयोग करके पीडीएफ फाइल को क्लाउड पर अपलोड करेंगे:

// यह कोड उदाहरण दर्शाता है कि पीडीएफ फाइल को क्लाउड पर कैसे अपलोड किया जाए।
// एपीआई का एक उदाहरण प्रारंभ करें
$apiInstance = new GroupDocs\Annotation\FileApi($configuration);

// दस्तावेज पथ
$file = "C:\\Files\\Annotation\\sample.pdf";

// अपलोड फ़ाइल अनुरोध बनाएँ
$request = new GroupDocs\Annotation\Model\Requests\UploadFileRequest("sample.pdf", $file, self::$MyStorage, null);

// फ़ाइल अपलोड करें
$response = $apiInstance->uploadFile($request);

नतीजतन, अपलोड की गई पीडीएफ फाइल क्लाउड पर डैशबोर्ड के फाइल सेक्शन में उपलब्ध होगी।

PHP का उपयोग कर पीडीएफ दस्तावेज़ एनोटेट करें

अब, हम नीचे दिए गए चरणों का पालन करके प्रोग्रामेटिक रूप से अपलोड किए गए पीडीएफ दस्तावेज़ में कई एनोटेशन जोड़ेंगे:

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

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

// यह कोड उदाहरण दर्शाता है कि पीडीएफ में एकाधिक एनोटेशन कैसे जोड़ना है।
// एनोटेशनएपीआई इंस्टेंस को इनिशियलाइज़ करें
$apiInstance = new GroupDocs\Annotation\एन्नोटेटApi($configuration);

// दूरी एनोटेशन जोड़ें
$a = new GroupDocs\Annotation\Model\AnnotationInfo();
$pt = new GroupDocs\Annotation\Model\Point();
$pt->setX(1);
$pt->setY(1);
$a->setAnnotationPosition($pt);
$box = new GroupDocs\Annotation\Model\Rectangle();
$box->setX(100);
$box->setY(100);
$box->setWidth(200);
$box->setHeight(100);
$a->setBox($box);
$a->setPageNumber(0);
$a->setPenColor(1201033);
$a->setPenStyle(GroupDocs\Annotation\Model\AnnotationInfo::PEN_STYLE_SOLID);
$a->setPenWidth(1);
$a->setOpacity(0.7);
$a->setType(GroupDocs\Annotation\Model\AnnotationInfo::TYPE_DISTANCE);
$a->setText("This is distance annotation");
$a->setCreatorName("Anonym A.");  

// क्षेत्र एनोटेशन जोड़ें
$a1 = new GroupDocs\Annotation\Model\AnnotationInfo();
$pt1 = new GroupDocs\Annotation\Model\Point();
$pt1->setX(1);
$pt1->setY(1);
$a1->setAnnotationPosition($pt1);
$box1 = new GroupDocs\Annotation\Model\Rectangle();
$box1->setX(80);
$box1->setY(400);
$box1->setWidth(200);
$box1->setHeight(100);
$a1->setBox($box1);
$a1->setPageNumber(0);
$a1->setPenColor(1201033);
$a1->setPenStyle(GroupDocs\Annotation\Model\AnnotationInfo::PEN_STYLE_SOLID);
$a1->setPenWidth(1);
$a1->setOpacity(0.7);
$a1->setType(GroupDocs\Annotation\Model\AnnotationInfo::TYPE_AREA);
$a1->setText("This is area annotation");
$a1->setCreatorName("Anonym A.");   

// बिंदु एनोटेशन जोड़ें
$a2 = new GroupDocs\Annotation\Model\AnnotationInfo();
$pt2 = new GroupDocs\Annotation\Model\Point();
$pt2->setX(100);
$pt2->setY(100);
$a2->setAnnotationPosition($pt2);
$box2 = new GroupDocs\Annotation\Model\Rectangle();
$box2->setX(450);
$box2->setY(150);
$box2->setWidth(100);
$box2->setHeight(30);
$a2->setBox($box2);
$a2->setPageNumber(0);
$a2->setOpacity(0.7);
$a2->setType(GroupDocs\Annotation\Model\AnnotationInfo::TYPE_POINT);
$a2->setText("This is point annotation");
$a2->setCreatorName("Anonym A.");  

// तीर एनोटेशन जोड़ें
$a3 = new GroupDocs\Annotation\Model\AnnotationInfo();
$pt3 = new GroupDocs\Annotation\Model\Point();
$pt3->setX(1);
$pt3->setY(1);
$a3->setAnnotationPosition($pt3);
$box3 = new GroupDocs\Annotation\Model\Rectangle();
$box3->setX(350);
$box3->setY(350);
$box3->setWidth(200);
$box3->setHeight(100);
$a3->setBox($box3);
$a3->setPageNumber(0);
$a3->setPenColor(1201033);
$a3->setPenStyle(GroupDocs\Annotation\Model\AnnotationInfo::PEN_STYLE_SOLID);
$a3->setPenWidth(1);
$a3->setOpacity(0.7);
$a3->setType(GroupDocs\Annotation\Model\AnnotationInfo::TYPE_ARROW);
$a3->setText("This is arrow annotation");
$a3->setCreatorName("Anonym A.");  

// इनपुट फ़ाइल पथ
$fileInfo = new GroupDocs\Annotation\Model\FileInfo();
$fileInfo->setFilePath("sample.pdf");

// एनोटेट विकल्पों को परिभाषित करें
$options = new GroupDocs\Annotation\Model\एन्नोटेटOptions();
$options->setFileInfo($fileInfo);
$options->setAnnotations([$a, $a1, $a2, $a3]);
$options->setOutputPath("MultipleAnnotation.pdf");

// एनोटेट अनुरोध बनाएँ
$request = new GroupDocs\Annotation\Model\Requests\annotateRequest($options);

// एन्नोटेट
$result = $apiInstance->annotate($request);
echo "AddMultipleAnnotations: Multiple Annotations added: " . $result->getHref();
PHP का उपयोग कर पीडीएफ दस्तावेज़ एनोटेट करें

PHP का उपयोग कर पीडीएफ दस्तावेज़ एनोटेट करें।

आप प्रलेखन में एनोटेशन जोड़ना अनुभाग के तहत समर्थित एनोटेशन प्रकारों के बारे में अधिक पढ़ सकते हैं।

एनोटेटेड फ़ाइल डाउनलोड करें

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

// यह कोड उदाहरण दर्शाता है कि क्लाउड से पीडीएफ फाइल कैसे डाउनलोड करें।
// एपीआई के एक उदाहरण को शुरू करना
$apiInstance = new GroupDocs\Annotation\FileApi($configuration);

// डाउनलोड फ़ाइल अनुरोध बनाएँ
$request = new GroupDocs\Annotation\Model\Requests\DownloadFileRequest("MultipleAnnotation.pdf", self::$MyStorage, null);

// डाउनलोड फ़ाइल
$response = $apiInstance->downloadFile($request);

हम नीचे दिए गए चरणों का पालन करके पीडीएफ दस्तावेज़ में हाइपरलिंक एनोटेशन भी जोड़ सकते हैं:

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

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

// यह कोड उदाहरण दर्शाता है कि पीडीएफ में लिंक एनोटेशन कैसे जोड़ा जाए
// एनोटेशनएपीआई इंस्टेंस को इनिशियलाइज़ करें
$apiInstance = new GroupDocs\Annotation\एन्नोटेटApi($configuration);

// लिंक एनोटेशन जोड़ें
$a = new GroupDocs\Annotation\Model\AnnotationInfo();
$pt1 = new GroupDocs\Annotation\Model\Point();
$pt1->setX(80);
$pt1->setY(710);
$pt2 = new GroupDocs\Annotation\Model\Point();
$pt2->setX(240);
$pt2->setY(710);		
$pt3 = new GroupDocs\Annotation\Model\Point();
$pt3->setX(80);
$pt3->setY(650);		
$pt4 = new GroupDocs\Annotation\Model\Point();
$pt4->setX(240);
$pt4->setY(650);		
$a->setPoints([$pt1, $pt2, $pt3, $pt4]);
$a->setUrl("https://www.groupdocs.com/");
$a->setPageNumber(0);
$a->setFontColor(1201033);
$a->setType(GroupDocs\Annotation\Model\AnnotationInfo::TYPE_LINK);
$a->setText("This is link annotation");
$a->setCreatorName("Anonym A.");   

// इनपुट फ़ाइल पथ
$fileInfo = new GroupDocs\Annotation\Model\FileInfo();
$fileInfo->setFilePath("sample.pdf");

// एनोटेट विकल्पों को परिभाषित करें
$options = new GroupDocs\Annotation\Model\एन्नोटेटOptions();
$options->setFileInfo($fileInfo);
$options->setAnnotations([$a]);
$options->setOutputPath("AddLinkAnnotation.pdf");

// एनोटेट अनुरोध बनाएँ
$request = new GroupDocs\Annotation\Model\Requests\annotateRequest($options);

// एन्नोटेट
$result = $apiInstance->annotate($request);
echo "AddLinkAnnotation: Link Annotation added: " . $result->getHref();
PHP का उपयोग करके लिंक एनोटेशन के साथ एनोटेट करें।

PHP का उपयोग करके लिंक एनोटेशन के साथ एनोटेट करें।

PHP का उपयोग करके छवि एनोटेशन जोड़ें

हम पहले बताए गए चरणों का पालन करके पीडीएफ दस्तावेज़ में इमेज एनोटेशन जोड़ सकते हैं। हालाँकि, हमें केवल एनोटेशन प्रकार को छवि पर सेट करने की आवश्यकता है जैसा कि नीचे दिखाया गया है:

$a->setType(GroupDocs\Annotation\Model\AnnotationInfo::TYPE_IMAGE);

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

// यह कोड उदाहरण दर्शाता है कि पीडीएफ में इमेज एनोटेशन कैसे जोड़ा जाए
// एनोटेशनएपीआई इंस्टेंस को इनिशियलाइज़ करें
$apiInstance = new GroupDocs\Annotation\एन्नोटेटApi($configuration);

// छवि एनोटेशन जोड़ें
$a = new GroupDocs\Annotation\Model\AnnotationInfo();
$pt = new GroupDocs\Annotation\Model\Point();
$pt->setX(1);
$pt->setY(1);
$a->setAnnotationPosition($pt);
$box = new GroupDocs\Annotation\Model\Rectangle();
$box->setX(200);
$box->setY(0);
$box->setWidth(200);
$box->setHeight(100);
$a->setBox($box);
$a->setPageNumber(0);
$a->setImagePath("groupdocs.png");
$a->setPenStyle(GroupDocs\Annotation\Model\AnnotationInfo::PEN_STYLE_SOLID);
$a->setOpacity(0.7);
$a->setType(GroupDocs\Annotation\Model\AnnotationInfo::TYPE_IMAGE);
$a->setText("This is image annotation");
$a->setCreatorName("Anonym A.");   

// इनपुट फ़ाइल पथ
$fileInfo = new GroupDocs\Annotation\Model\FileInfo();
$fileInfo->setFilePath("sample.pdf");

// एनोटेट विकल्पों को परिभाषित करें
$options = new GroupDocs\Annotation\Model\एन्नोटेटOptions();
$options->setFileInfo($fileInfo);
$options->setAnnotations([$a]);
$options->setOutputPath("AddImageAnnotation.pdf");

// एनोटेट अनुरोध बनाएँ
$request = new GroupDocs\Annotation\Model\Requests\annotateRequest($options);

// एन्नोटेट
$result = $apiInstance->annotate($request);
echo "AddImageAnnotation: Image Annotation added: " . $result->getHref();
PHP का उपयोग करके छवि एनोटेशन जोड़ें।

PHP का उपयोग करके छवि एनोटेशन जोड़ें।

PHP का उपयोग करके टेक्स्ट फील्ड एनोटेशन जोड़ें

हम पहले बताए गए चरणों का पालन करके पीडीएफ दस्तावेज़ में टेक्स्ट फ़ील्ड एनोटेशन भी जोड़ सकते हैं। हालाँकि, हमें एनोटेशन प्रकार को टेक्स्ट फ़ील्ड में सेट करने की आवश्यकता है जैसा कि नीचे दिखाया गया है:

$a->setType(GroupDocs\Annotation\Model\AnnotationInfo::TYPE_TEXT_FIELD);

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

// यह कोड उदाहरण दर्शाता है कि पीडीएफ में टेक्स्ट फ़ील्ड एनोटेशन कैसे जोड़ा जाए
// एनोटेशनएपीआई इंस्टेंस को इनिशियलाइज़ करें
$apiInstance = new GroupDocs\Annotation\एन्नोटेटApi($configuration);

// टेक्स्टफिल्ड एनोटेशन जोड़ें
$a = new GroupDocs\Annotation\Model\AnnotationInfo();
$pt = new GroupDocs\Annotation\Model\Point();
$pt->setX(1);
$pt->setY(1);
$a->setAnnotationPosition($pt);
$box = new GroupDocs\Annotation\Model\Rectangle();
$box->setX(380);
$box->setY(300);
$box->setWidth(100);
$box->setHeight(50);
$a->setBox($box);
$a->setPageNumber(0);
$a->setFontColor(1201033);
$a->setFontSize(12);
$a->setOpacity(0.7);
$a->setType(GroupDocs\Annotation\Model\AnnotationInfo::TYPE_TEXT_FIELD);
$a->setText("Text field text");
$a->setCreatorName("Anonym A.");   

// इनपुट फ़ाइल पथ
$fileInfo = new GroupDocs\Annotation\Model\FileInfo();
$fileInfo->setFilePath("sample.pdf");

// एनोटेट विकल्पों को परिभाषित करें
$options = new GroupDocs\Annotation\Model\एन्नोटेटOptions();
$options->setFileInfo($fileInfo);
$options->setAnnotations([$a]);
$options->setOutputPath("AddTextFieldAnnotation.pdf");

// एनोटेट अनुरोध बनाएँ
$request = new GroupDocs\Annotation\Model\Requests\annotateRequest($options);

// एन्नोटेट
$result = $apiInstance->annotate($request);
echo "AddTextFieldAnnotation: Text Field Annotation added: " . $result->getHref();
PHP का उपयोग करके टेक्स्ट फील्ड एनोटेशन जोड़ें।

PHP का उपयोग करके टेक्स्ट फील्ड एनोटेशन जोड़ें।

ऑनलाइन प्रयास करें

कृपया निम्नलिखित मुफ्त ऑनलाइन पीडीएफ एनोटेशन टूल का प्रयास करें, जिसे उपरोक्त एपीआई का उपयोग करके विकसित किया गया है। https://products.groupdocs.app/annotation/pdf

निष्कर्ष

इस लेख में, हमने सीखा है कि कैसे:

  • PHP का उपयोग करके पीडीएफ में एकाधिक एनोटेशन जोड़ें;
  • PHP में लिंक, इमेज और टेक्स्ट फील्ड एनोटेशन के साथ पीडीएफ को एनोटेट करें;
  • प्रोग्रामेटिक रूप से पीडीएफ फाइल को क्लाउड पर अपलोड करें;
  • क्लाउड से एनोटेटेड पीडीएफ फाइल डाउनलोड करें।

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

यह सभी देखें