ابحث عن العلامة المائية واستبدلها باستخدام REST API

العلامة المائية هي صورة أو نص متراكب يستخدم للعرض في المستندات لأغراض مختلفة. في بعض الأحيان ، قد تحتاج إلى استبدال أو تحرير العلامة المائية المدرجة بنص أو صورة جديدة. ستركز هذه المقالة على كيفية البحث عن نص العلامة المائية أو الصور واستبدالها باستخدام واجهة برمجة تطبيقات REST.

سيتم تناول الموضوعات التالية في هذه المقالة:

• Watermark REST API و .NET SDK
• ابحث عن نص العلامة المائية واستبدلها باستخدام واجهة برمجة تطبيقات REST
• ابحث عن صورة العلامة المائية واستبدلها باستخدام واجهة برمجة تطبيقات REST

Watermark REST API و .NET SDK

للبحث واستبدال العلامة المائية ، سأستخدم .NET SDK من GroupDocs.Watermark Cloud API. يسمح لك بإضافة العلامات المائية وإزالتها والبحث عنها واستبدالها برمجيًا من الصور والمستندات ذات التنسيقات المدعومة. حاليًا ، يوفر أيضًا Java SDK أيضًا لـ Cloud API.

يمكن تثبيت GroupDocs.Watermark Cloud SDK for .NET على مشروع Visual Studio الخاص بك من مدير حزمة NuGet كما هو موضح أدناه:

يمكنك أيضًا تثبيت حزمة NuGet باستخدام الأمر التالي في وحدة تحكم مدير الحزم:

Install-Package GroupDocs.Watermark-Cloud

يرجى الحصول على معرّف العميل وسر العميل من لوحة القيادة قبل البدء في اتباع الخطوات وأمثلة الكود المتاحة. أضف معرّفك وسرّك في الرمز كما هو موضح أدناه:

string MyClientId = "YOUR-CLIENT-ID";
string MyClientSecret = "YOUR-CLIENT-SECRET";

var config = new Configuration(MyClientId, MyClientSecret);
var watermarkApi = new WatermarkApi(config);
var fileApi = new FileApi(config);
var storageApi = new StorageApi(config);

ابحث عن نص العلامة المائية واستبدلها باستخدام واجهة برمجة تطبيقات REST

يمكنك العثور على نص العلامة المائية واستبداله من مستندات PDF الخاصة بك باتباع الخطوات البسيطة المذكورة أدناه:

• رفعthe PDF document to the Cloud
• Find and Replace Text Watermark من ملف PDF الذي تم تحميله
• تحميلthe updated file

قم بتحميل مستند PDF

بادئ ذي بدء ، قم بتحميل مستند PDF الذي يحتوي على العلامة المائية على السحابة باستخدام أي من الطرق التالية:

• استخدام لوحة التحكم
• قم بتحميل الملف باستخدام Upload File API من المتصفح
• قم بالتحميل برمجيًا باستخدام مثال الرمز الموضح أدناه:

var path = @"C:\Files\";
string MyStorage = null;

var file = Directory.GetFiles(path, "Sample.pdf", SearchOption.AllDirectories).FirstOrDefault();
if (file.Length != 0)
{
	var relativeFilePath = file.Replace(path, string.Empty).Trim(Path.DirectorySeparatorChar);

	var fileStream = File.Open(file, FileMode.Open);
	fileApi.UploadFile(new UploadFileRequest(relativeFilePath, fileStream, MyStorage));
	fileStream.Close();
}

نتيجة لذلك ، سيتم تحميل ملف PDF إلى Cloud Storage وسيكون متاحًا في قسم الملفات من لوحة المعلومات الخاصة بك.

البحث عن واستبدال النص العلامة المائية

يوضح مقتطف الشفرة التالي كيفية البحث عن علامة مائية نصية واستبدالها من ملف PDF تم تحميله باستخدام واجهة برمجة تطبيقات REST.

public static string FindAndReplaceTextWatermark(WatermarkApi watermarkApi)
{
    var options = new ReplaceOptions
    {
        FileInfo = new GroupDocs.Watermark.Cloud.Sdk.Model.FileInfo
        {
            FilePath = "Sample.pdf"
        },
        TextSearchCriteria = new TextSearchCriteria
        {
            SearchText = "Watermark Text"
        },
        ReplaceTextOptions = new ReplaceTextOptions
        {
            Text = "Confidential",
        }
    };
    var request = new ReplaceRequest(options);
    var result = watermarkApi.Replace(request);

    return result.Path;
}

يمكنك أيضًا تعيين الخط وحجم النص وألوان المقدمة والخلفية لنص العلامة المائية باستخدام نموذج التعليمات البرمجية التالي:

ReplaceTextOptions = new ReplaceTextOptions
{
    Text = "Confidential",
    FontFamily = "Arial",
    Size = 20d,
    ForegroundColor = new Color { A = 0, R = 0, G = 100, B = 0 }
}

قم بتنزيل الملف المحدث

ستحفظ عينات الكود أعلاه ملف PDF بنص أو صورة علامة مائية جديدة على السحابة. يمكنك تنزيله باستخدام نموذج التعليمات البرمجية التالي:

var downloadRequest = new DownloadFileRequest(file, MyStorage);

Stream downloadResponse = fileApi.DownloadFile(downloadRequest);
using (var fileStream = System.IO.File.Create("C:\\Files\\DownloadedFile.pdf"))
{
	downloadResponse.Seek(0, SeekOrigin.Begin);
	downloadResponse.CopyTo(fileStream);
}

ابحث عن صورة العلامة المائية واستبدلها باستخدام واجهة برمجة تطبيقات REST

يوضح مثال الكود البسيط الوارد أدناه كيفية البحث عن صورة العلامة المائية واستبدالها باستخدام واجهة برمجة تطبيقات REST. يرجى اتباع الخطوات المذكورة سابقاً لتحميل وتنزيل ملف.

public static string FindAndReplaceImageWatermark(WatermarkApi watermarkApi)
{
    var options = new ReplaceOptions
    {
        FileInfo = new GroupDocs.Watermark.Cloud.Sdk.Model.FileInfo
        {
            FilePath = "Sample.pdf"
        },
        ImageSearchCriteria = new ImageSearchCriteria
        {
            ImageFileInfo = new GroupDocs.Watermark.Cloud.Sdk.Model.FileInfo
            {
                FilePath = "sample_watermark.png"
            }
        },
        ReplaceImageOptions = new ReplaceImageOptions
        {
            Image = new GroupDocs.Watermark.Cloud.Sdk.Model.FileInfo
            {
                FilePath = "Logo.png"
            }
        }
    };
    var request = new ReplaceRequest(options);
    var result = watermarkApi.Replace(request);

    return result.Path;
}

خاتمة

في الختام ، تعلمت كيفية البحث عن النص أو العلامة المائية للصورة واستبدالها من مستند PDF على السحابة باستخدام .NET Watermark REST API باستخدام C#. علاوة على ذلك ، تعلمت أيضًا كيفية تحميل الملفات برمجيًا على السحابة ثم تنزيلها من السحابة. علاوة على ذلك ، يمكنك معرفة العديد من الميزات المفيدة الأخرى في GroupDocs.Watermark Cloud API من الوثائق. في حالة وجود أي غموض ، لا تتردد في الاتصال بـ الدعم.

أنظر أيضا

• Watermark Cloud API & SDKs لتأمين المستندات