ウォーターマークは、さまざまな目的で文書内に表示するために使用される、重ね合わされた画像またはテキストです。場合によっては、挿入した透かしを新しいテキストまたは画像に置き換えたり、編集したりする必要がある場合があります。この記事では、REST API を使用して透かしテキストまたは画像を検索および置換する方法に焦点を当てます。

この記事では次のトピックについて説明します。

ウォーターマーク REST API と .NET SDK

GroupDocs.Watermark クラウド製品ファミリー

ウォーターマークの検索と置換には、GroupDocs.Watermark Cloud の .NET SDK API を使用します。サポートされている形式の画像やドキュメントの透かしをプログラムで追加、削除、検索、置換できます。現在、クラウド API 用に Java SDK も提供しています。

GroupDocs.Watermark Cloud SDK for .NET は、以下に示すように、NuGet パッケージ マネージャーから Visual Studio プロジェクトにインストールできます。

Rest API を使用したウォーターマークの検索と置換

パッケージ マネージャー コンソールで次のコマンドを使用して、NuGet パッケージをインストールすることもできます。

Install-Package GroupDocs.Watermark-Cloud

手順と利用可能なコード例を開始する前に、ダッシュボード からクライアント ID とクライアント シークレットを取得してください。以下に示すように、コードに ID とシークレットを追加します。

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 ドキュメントから透かしテキストを検索して置換できます。

PDFドキュメントをアップロードする

まず、次のいずれかの方法を使用して、ウォーターマークを含む PDF ドキュメントをクラウドにアップロードします。

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 にアップロードされ、ダッシュボードの ファイル セクション で利用できるようになります。

テキスト透かしの検索と置換

次のコード スニペットは、REST API を使用して、アップロードされた PDF ファイルからテキストの透かしを検索して置換する方法を示しています。

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;
}
REST APIを使用したテキスト透かしの検索と置換

次のコード サンプルを使用して、ウォーターマーク テキストのフォント、テキスト サイズ、前景色と背景色を設定することもできます。

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;
}
REST APIを使用した透かし画像の検索と置換

結論

結論として、C# を使用した .NET Watermark REST API を使用して、クラウド上の PDF ドキュメントからテキストまたは画像のウォーターマークを検索して置換する方法を学習しました。さらに、プログラムによってファイルをクラウドにアップロードし、クラウドからダウンロードする方法も学習しました。さらに、GroupDocs.Watermark Cloud API のその他のさまざまな便利な機能については、ドキュメント から学ぶことができます。不明な点がある場合は、サポート までお気軽にお問い合わせください。

関連項目