با استفاده از REST API، Watermark را پیدا و جایگزین کنید

واترمارک یک تصویر یا متن روی هم قرار گرفته است که برای نمایش در اسناد برای اهداف مختلف استفاده می شود. گاهی اوقات، ممکن است لازم باشد واترمارک درج شده را با یک متن یا تصویر جدید جایگزین یا ویرایش کنید. این مقاله بر نحوه یافتن و جایگزینی متن یا تصاویر واترمارک با استفاده از REST API تمرکز خواهد کرد.

موضوعات زیر در این مقاله پوشش داده خواهد شد:

• Watermark REST API و NET SDK
• با استفاده از REST API، متن واترمارک را پیدا و جایگزین کنید
• با استفاده از REST API تصویر واترمارک را پیدا و جایگزین کنید

Watermark REST API و NET SDK

برای جستجو و جایگزینی واترمارک، از .NET SDK of GroupDocs.Watermark Cloud API استفاده خواهم کرد. این به شما اجازه می دهد تا به صورت برنامه ریزی شده، واترمارک ها را از تصاویر و اسناد فرمت های پشتیبانی شده اضافه، حذف، جستجو و جایگزین کنید. در حال حاضر، جاوا SDK را نیز برای Cloud API ارائه می کند.

GroupDocs.Watermark Cloud SDK برای دات نت را می توان از طریق مدیر بسته NuGet در پروژه ویژوال استودیو مانند شکل زیر نصب کرد:

همچنین می‌توانید بسته NuGet را با استفاده از دستور زیر در کنسول Package Manager نصب کنید:

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 API، متن واترمارک را پیدا و جایگزین کنید

با دنبال کردن مراحل ساده زیر می توانید متن واترمارک را از اسناد PDF خود پیدا کرده و جایگزین کنید:

• بارگذاریthe PDF document to the Cloud
• Find and Replace Text Watermark از فایل PDF آپلود شده
• دانلودthe updated file

سند PDF را بارگذاری کنید

اول از همه، سند PDF حاوی واترمارک را با استفاده از یکی از روش های زیر در Cloud آپلود کنید:

• با استفاده از dashboard
• فایل را با استفاده از 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 در فضای ذخیره‌سازی ابری آپلود می‌شود و در بخش فایل‌ها داشبورد شما در دسترس خواهد بود.

یافتن و جایگزینی واترمارک متنی

قطعه کد زیر نحوه یافتن و جایگزینی واترمارک متنی را از فایل PDF آپلود شده با استفاده از REST API نشان می دهد.

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 API تصویر واترمارک را پیدا و جایگزین کنید

مثال کد ساده ارائه شده در زیر نشان می دهد که چگونه می توان تصویر واترمارک را با استفاده از REST API پیدا کرد و جایگزین کرد. لطفاً برای آپلود و دانلود یک فایل مراحل ذکر شده را دنبال کنید.

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;
}

نتیجه

در پایان، یاد گرفتید که چگونه با استفاده از C#، متن یا تصویر را از یک سند PDF در فضای ابری با .NET Watermark REST API جستجو و جایگزین کنید. علاوه بر این، شما همچنین یاد گرفتید که چگونه به صورت برنامه‌نویسی فایل‌ها را روی ابر آپلود کنید و سپس آنها را از ابر دانلود کنید. علاوه بر این، می‌توانید ویژگی‌های مفید دیگر GroupDocs.Watermark Cloud API را از مستندات بیاموزید. در صورت وجود هرگونه ابهام، با [پشتیبانی] تماس بگیرید8.

همچنین ببینید

• Watermark Cloud API & SDKs برای ایمن کردن اسناد