pdf manipulation on Document Processing REST APIs | GroupDocs Cloud

REST を使用して Node.JS で PDF から注釈オブジェクトを削除する

Wed, 21 Oct 2026 13:18:44 +0000

PDFから不要なメモ、ハイライト、またはインクマークを削除することは、配布用にクリーンな文書を準備する際によくある要件です。GroupDocs.Annotation Cloud SDK for Node.js は、REST ベースの強力なライブラリを提供し、PDF アノテーションをプログラムで管理できます。このガイドでは、Node.JS で REST を使用して PDF から Annotation オブジェクトを削除する方法をステップバイステップで示します。完全なコード例、同等の cURL コマンド、構成のヒント、ベストプラクティスの推奨事項を確認し、アノテーション削除をサービスに統合する方法を学びます。

REST を使用して Node.JS で PDF から注釈オブジェクトを削除する完全な動作例

この例では、PDF をアップロードし、すべての注釈を削除し、GroupDocs.Annotation SDK を使用してクリーンアップされたファイルをダウンロードする方法を示します。

const fs = require('fs');
const path = require('path');
const GroupDocsAnnotationCloud = require("@groupdocs/annotation-cloud");

// ==== Authentication =========================================================
const clientId = "YOUR_CLIENT_ID";
const clientSecret = "YOUR_CLIENT_SECRET";

const config = new GroupDocsAnnotationCloud.Configuration(clientId, clientSecret);
const annotationsApi = new GroupDocsAnnotationCloud.AnnotationsApi(config);
const storageApi = new GroupDocsAnnotationCloud.StorageApi(config);

// ==== Local & Remote file definitions =======================================
const localInputPath = path.resolve(__dirname, "input.pdf");
const localOutputPath = path.resolve(__dirname, "output.pdf");
const remoteFilePath = "input.pdf";

// ==== Main workflow ==========================================================
(async () => {
    // 1. Upload PDF to GroupDocs Cloud storage
    const fileBytes = fs.readFileSync(localInputPath);
    const uploadRequest = new GroupDocsAnnotationCloud.UploadFileRequest({
        path: remoteFilePath,
        file: fileBytes
    });
    await storageApi.uploadFile(uploadRequest);

// 2. Build FileInfo object for the uploaded PDF
    const fileInfo = new GroupDocsAnnotationCloud.FileInfo({
        filePath: remoteFilePath
    });

// 3. Retrieve all existing annotations
    const getAnnotationsRequest = new GroupDocsAnnotationCloud.GetAnnotationsRequest({
        fileInfo: fileInfo
    });
    const annotationsResult = await annotationsApi.getAnnotations(getAnnotationsRequest);
    const annotationIds = (annotationsResult.annotations || []).map(a => a.id);

// 4. Delete all annotations (if any)
    if (annotationIds.length > 0) {
        const deleteRequest = new GroupDocsAnnotationCloud.DeleteAnnotationsRequest({
            fileInfo: fileInfo,
            annotationIds: annotationIds
        });
        await annotationsApi.deleteAnnotations(deleteRequest);
    }

// 5. Download the cleaned PDF back to local storage
    const downloadRequest = new GroupDocsAnnotationCloud.DownloadFileRequest({
        path: remoteFilePath
    });
    const fileStream = await storageApi.downloadFile(downloadRequest);
    fs.writeFileSync(localOutputPath, fileStream);
    console.log(`All annotations removed. Clean file saved to ${localOutputPath}`);
})();

注意: このコード例はコア機能を示しています。プロジェクトで使用する前に、ファイルパスや設定値を実際の環境に合わせて更新し、必要な依存関係がすべて正しくインストールされていることを確認し、開発環境で徹底的にテストしてください。問題が発生した場合は、公式ドキュメントを参照するか、サポートチームにお問い合わせください。

cURL を使用した REST API で PDF アノテーションを削除する

以下は、GroupDocs.Annotation Cloud の REST エンドポイントを使用して同じ注釈削除ワークフローを実行する cURL コマンドです。

# 1. Obtain an access token
curl -X POST "https://api.groupdocs.cloud/v2.0/auth/token" \
     -H "Content-Type: application/json" \
     -d "{\"client_id\":\"YOUR_CLIENT_ID\",\"client_secret\":\"YOUR_CLIENT_SECRET\"}"

# 2. Upload the source PDF
curl -X PUT "https://api.groupdocs.cloud/v2.0/storage/file/input.pdf" \
     -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
     -H "Content-Type: application/pdf" \
     --data-binary "@input.pdf"

# 3. アノテーション ID の取得
curl -X GET "https://api.groupdocs.cloud/v2.0/annotation/annotations?filePath=input.pdf" \
     -H "Authorization: Bearer YOUR_ACCESS_TOKEN"

# 4. Delete all retrieved annotations
curl -X DELETE "https://api.groupdocs.cloud/v2.0/annotation/annotations?filePath=input.pdf" \
     -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
     -H "Content-Type: application/json" \
     -d "{\"annotationIds\":[\"id1\",\"id2\"]}"

# 5. Download the cleaned PDF
curl -X GET "https://api.groupdocs.cloud/v2.0/storage/file/input.pdf" \
     -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
     -o output.pdf

エンドポイントとパラメータの完全な一覧については、公式 API ドキュメントをご覧ください。

REST と Node.JS で PDF からアノテーションオブジェクトを削除する方法

認証設定 - Configuration クラスは clientId と clientSecret を使用してインスタンス化され、以降のすべての API 呼び出しに対する認証済みコンテキストを作成します。
```
const config = new GroupDocsAnnotationCloud.Configuration(clientId, clientSecret);
```
ファイルアップロード - UploadFileRequest はローカル PDF バイト列を GroupDocs Cloud ストレージに送信します。storageApi.uploadFile メソッドが転送を処理します。
```
const uploadRequest = new GroupDocsAnnotationCloud.UploadFileRequest({
    path: remoteFilePath,
    file: fileBytes
});
await storageApi.uploadFile(uploadRequest);
```
アノテーションの取得 - GetAnnotationsRequest は FileInfo 参照を含むリクエストオブジェクトを構築します。annotationsApi.getAnnotations 呼び出しはアノテーションオブジェクトのコレクションを返し、そこから ID が抽出されます。
```
const getAnnotationsRequest = new GroupDocsAnnotationCloud.GetAnnotationsRequest({
    fileInfo: fileInfo
});
const annotationsResult = await annotationsApi.getAnnotations(getAnnotationsRequest);
```
アノテーションの削除 - ID が存在する場合、DeleteAnnotationsRequest が設定され annotationsApi.deleteAnnotations に渡され、保存された PDF からアノテーションが永久に削除されます。
```
const deleteRequest = new GroupDocsAnnotationCloud.DeleteAnnotationsRequest({
    fileInfo: fileInfo,
    annotationIds: annotationIds
});
await annotationsApi.deleteAnnotations(deleteRequest);
```

クリーンな PDF のダウンロード - 最後に、DownloadFileRequest が更新されたファイルを取得し、fs.writeFileSync がローカルファイルシステムに書き込みます。

const downloadRequest = new GroupDocsAnnotationCloud.DownloadFileRequest({
    path: remoteFilePath
});
const fileStream = await storageApi.downloadFile(downloadRequest);
fs.writeFileSync(localOutputPath, fileStream);

クラスとメソッドの詳細な定義については、API リファレンスを参照してください。

インストールと構成 GroupDocs.Annotation Cloud SDK for Node.js

SDK は npm パッケージとして配布されています。以下のコマンドでインストールし、プロジェクトで require してください。

npm install groupdocs-annotation-cloud

最新のパッケージは、GitHub リリースページまたは公式のダウンロード URL から直接ダウンロードできます。

インストール後、ライブラリをインポートし、コード例に示すように構成オブジェクトを作成します。

const GroupDocsAnnotationCloud = require("@groupdocs/annotation-cloud");
const config = new GroupDocsAnnotationCloud.Configuration("YOUR_CLIENT_ID", "YOUR_CLIENT_SECRET");

実行環境が Node.js のバージョン要件を満たしていること、そしてクライアント認証情報を取得するために有効な GroupDocs アカウントを持っていることを確認してください。

アノテーション削除オプションと設定

SDK は調整できる複数のパラメータを提供しています：

clientId / clientSecret - OAuth認証のためのクレデンシャルです。Configuration コンストラクタで設定します。
fileInfo.filePath - GroupDocs Cloud ストレージ内の PDF のパスです。別のフォルダーにファイルを保存している場合はこれを調整してください。
annotationIds - GetAnnotations が返す ID の配列です。サブセットを指定することで選択的に削除できます。

リクエストタイムアウトやプロキシ構成などの追加設定は SDK ドキュメントで利用可能です。完全な一覧については、公式ドキュメントをご覧ください。

REST を使用した PDF アノテーションの削除に関するベストプラクティス

アノテーションIDの検証 - 削除しようとしているIDが存在するか常に確認してください；存在しないIDを削除しようとすると404エラーが発生する可能性があります。
HTTPSを使用 - 認証情報とドキュメントデータを保護するため、すべてのAPI呼び出しはHTTPSで行う必要があります。
チャンクアップロードで大容量ファイルを処理 - 100 MBを超えるPDFの場合、タイムアウトを回避するためにマルチパートアップロードエンドポイントを使用することを推奨します。
APIレスポンスのログ記録 - 監査トレイルとトラブルシューティングを容易にするため、リクエストIDとレスポンスを保存してください。
アクセストークンの再利用 - 認証オーバーヘッドを削減するため、OAuthトークンが期限切れになるまでキャッシュしてください。

よくある質問

GroupDocs.Annotation Cloud API の認証方法は？
GroupDocs アカウントからクライアント ID とシークレットを取得し、OAuth エンドポイントを介してアクセストークンをリクエストします。詳細は公式ドキュメントをご覧ください。
特定のアノテーションだけを削除できますか？
はい、削除したいアノテーションの ID を DeleteAnnotationsRequest に指定してください。SDK は GetAnnotations 呼び出しの後にアノテーション ID のリストを返します。
Node.JS の REST で PDF から Annotation オブジェクトを削除するにはどうすればよいですか？
GroupDocs.Annotation Cloud SDK for Node.js を使用して、アノテーション ID を取得した後に DeleteAnnotations エンドポイントを呼び出します。このガイドのコード例と cURL セクションでフルワークフローが示されています。
本番使用にはどのようなライセンスが必要ですか？
本番環境では有料ライセンスが必要です。評価中は一時ライセンスページから取得できます。

Node.JSでPDFをマージする

Mon, 19 Oct 2026 15:04:19 +0000

複数のPDFドキュメントを単一のファイルに結合することは、ドキュメントワークフローの構築やレポート作成時に頻繁に求められる要件です。GroupDocs.Merger Cloud SDK for Node.jsを使用すれば、低レベルのPDF構造を扱うことなく、Node.JSでPDFを簡単にマージできます。このガイドでは、セットアップからステップバイステップの実装、完全なコード例、同等のcURL呼び出し、そして大きなまたは暗号化されたPDFに対するパフォーマンスのヒントまでをご紹介します。

開始する前に: 前提条件とインストール

開始する前に、以下が揃っていることを確認してください：

開発マシンに Node.js 14 以降がインストールされていること。
クライアント ID とクライアントシークレットを持つ有効な GroupDocs Cloud アカウント。
結合したい PDF ファイルへのアクセス権があり、これらが GroupDocs Cloud ストレージに保存されていること。

npm を使用して SDK をインストールし、最新のパッケージをダウンロードします:

npm install groupdocs-merger-cloud

公式リリースページから SDK を取得することもできます: Download SDK。インストールが完了したら、すぐにコーディングを開始できます。

Node.JS で PDF をマージするステップバイステップガイド

ステップ 1: SDK のインストールと必要なクラスのインポート

まず、PDF を結合するために必要なクラスをインポートします。

const { MergeApi, MergeOptions, FileInfo, Configuration } = require("@groupdocs/merger-cloud");

このインポートにより、コア API、構成オブジェクト、およびファイルディスクリプタへのアクセスが可能になります。

ステップ 2: GroupDocs の認証情報を設定する

クライアント資格情報を使用して構成オブジェクトを作成します。

const config = new Configuration({
    clientId: "YOUR_CLIENT_ID",
    clientSecret: "YOUR_CLIENT_SECRET"
});

正しい認証情報を提供すると、ライブラリがリクエストを認証できるようになります。

ステップ 3: 結合する PDF ファイルを定義する

結合したい PDF ドキュメントを一覧にしてください。この手順により、Node.JS で PDF を効率的にマージできます。

const filesToMerge = [
    new FileInfo({ filePath: "input1.pdf" }),
    new FileInfo({ filePath: "input2.pdf" })
];

各 FileInfo は、GroupDocs Cloud ストレージに保存されているファイルを指します。

ステップ 4: マージオプションを設定

出力先を設定し、ファイルリストをマージリクエストに添付します。

const mergeOptions = new MergeOptions();
mergeOptions.fileInfos = filesToMerge;
mergeOptions.outputPath = "merged_output.pdf";

これらの設定は、Node.JS で PDF をマージする方法と、結果が保存される場所を制御します。

ステップ 5: マージ操作を実行する

API インスタンスを作成し、merge メソッドを呼び出して、レスポンスを処理します。

const mergeApi = new MergeApi(config);

try {
    const result = await mergeApi.mergeDocuments(mergeOptions);
    console.log("Merge completed. Output file stored at:", result.path);
} catch (error) {
    console.error("Error during PDF merge:", error);
}

非同期呼び出しは、操作が成功した場合、マージされたドキュメントのパスを返します。

Node.JS で PDF をマージする完全実装例

次のコードは、構成から結果の処理までの完全なワークフローを示しています。

const { MergeApi, MergeOptions, FileInfo, Configuration } = require("@groupdocs/merger-cloud");

// Configure the SDK (replace with your actual credentials)
const config = new Configuration({
    clientId: "YOUR_CLIENT_ID",
    clientSecret: "YOUR_CLIENT_SECRET"
});

async function mergePdfFiles() {
    // Initialize the Merge API
    const mergeApi = new MergeApi(config);

// Define the PDF files to be merged (must exist in GroupDocs Cloud storage)
    const filesToMerge = [
        new FileInfo({ filePath: "input1.pdf" }),
        new FileInfo({ filePath: "input2.pdf" })
    ];

// Set merge options
    const mergeOptions = new MergeOptions();
    mergeOptions.fileInfos = filesToMerge;
    mergeOptions.outputPath = "merged_output.pdf";

try {
        // Perform the merge operation
        const result = await mergeApi.mergeDocuments(mergeOptions);
        console.log("Merge completed. Output file stored at:", result.path);
    } catch (error) {
        console.error("Error during PDF merge:", error);
    }
}

// Execute the merge
mergePdfFiles();

Note: このコード例はコア機能を示しています。プロジェクトで使用する前に、ファイルパスや構成値を実際の環境に合わせて更新し、すべての必須依存関係が正しくインストールされていることを確認し、開発環境で徹底的にテストしてください。問題が発生した場合は、公式ドキュメントをご参照いただくか、サポートチームにお問い合わせください。

cURL を使用した REST API による PDF の結合

純粋なRESTアプローチを好む場合、同じ操作はcURLコマンドで実行できます。

まず、アクセストークンを取得します:

curl -X POST "https://api.groupdocs.cloud/v2.0/oauth2/token" \
     -H "Content-Type: application/json" \
     -d '{"client_id":"YOUR_CLIENT_ID","client_secret":"YOUR_CLIENT_SECRET","grant_type":"client_credentials"}'

ソースPDFをストレージにアップロードします（YOUR_ACCESS_TOKEN を前の手順から取得したトークンに置き換えてください）:

curl -X POST "https://api.groupdocs.cloud/v2.0/storage/file/upload?path=input1.pdf" \
     -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
     -F "file=@/local/path/input1.pdf"

input2.pdf のアップロードを繰り返します。次に、マージ操作をリクエストします：

curl -X POST "https://api.groupdocs.cloud/v2.0/merger/merge" \
     -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
     -H "Content-Type: application/json" \
     -d '{
           "fileInfos": [
               {"filePath":"input1.pdf"},
               {"filePath":"input2.pdf"}
           ],
           "outputPath":"merged_output.pdf"
         }'

最後に、マージされたファイルをダウンロードしてください:

curl -X GET "https://api.groupdocs.cloud/v2.0/storage/file/download?path=merged_output.pdf" \
     -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
     -o merged_output.pdf

エンドポイントとパラメータの完全な一覧については、API referenceをご確認ください。

マージオプションの設定

SDK はマージプロセスを微調整できるいくつかのオプションを提供します:

outputPath - 結合された PDF の保存先パス。結果が保存される場所を制御するために調整します。
fileInfos - ソース PDF とその順序を定義する FileInfo オブジェクトの配列。

特定のページ範囲を結合するための pages や、暗号化された PDF 用の password など、追加のプロパティを設定することもできます。設定可能なフィールドの完全な一覧については、公式ドキュメントを参照してください。

PDF のマージに関するパフォーマンス上の考慮事項

大きな PDF ファイルや多数の PDF ファイルを結合する際は、次のヒントを覚えておいてください。

async/await を使用して、特に大きなドキュメントでイベントループのブロックを回避します。
バッチアップロード: マージを呼び出す前にソース PDF を並列にアップロードし、全体のレイテンシを削減します。
ストリーム処理: 非常に大きな PDF の場合、途中結果をクラウドストレージに保存し、より小さなチャンクでマージすることを検討してください。
暗号化された PDF: FileInfo オブジェクトにパスワードを提供します。暗号化ファイルの処理はオーバーヘッドが増えるため、可能な限り復号後にマージしてください。

これらの実践を適用することで、Node.JS で PDF を効率的にマージし、メモリ消費を最小限に抑えることができます。

よくある質問

Node.JSでGroupDocsを使用してPDFファイルを結合するにはどうすればよいですか？
GroupDocs.Merger Cloud SDK for Node.js を使用して MergeApi インスタンスを作成し、ソースPDFを使用して MergeOptions を構成し、mergeDocuments を呼び出します。このガイドの完全なコード例がプロセスを示しています。
Node.JSで暗号化されたPDFファイルをマージできますか？
はい、SDKは暗号化されたPDFのマージをサポートしています。mergeDocuments を呼び出す前に、FileInfo オブジェクトに正しいパスワードを設定してください。詳細は公式ドキュメントをご覧ください。
GroupDocs.Merger のライセンスオプションは何ですか？
GroupDocs は柔軟な価格プランを提供しています。テスト用に、完全なサブスクリプションを購入する前にライブラリを評価するために、一時ライセンスをリクエストできます。
さらにサンプルやサポートはどこで見つけられますか？
追加のサンプルはGitHub リポジトリで入手できます。サポートが必要な場合は、サポートフォーラムをご覧ください。

さらに読む

JavaでPDFドキュメントに画像の透かしを追加する

Fri, 28 Aug 2026 19:41:04 +0000

PDF ファイルに視覚的な識別子を追加することは、知的財産の保護や文書のブランディングに不可欠です。
GroupDocs.Watermark Cloud SDK for Java は、Java アプリケーションから PDF に画像透かしを直接埋め込むシンプルな API を提供します。このチュートリアルでは、Java で PDF ドキュメントに画像透かしを追加する方法を学び、完全な動作例を確認し、クラウド統合のための同等の cURL REST 呼び出しも検討します。

JavaでPDFドキュメントに画像透かしを追加する5ステップ

API クライアントの初期化: クライアント ID とシークレットを使用して ApiClient インスタンスを作成します。

ApiClient apiClient = new ApiClient("YOUR_CLIENT_ID", "YOUR_CLIENT_SECRET");
WatermarkApi watermarkApi = new WatermarkApi(apiClient);

この手順により、Java コードが GroupDocs.Watermark Cloud サービスに接続されます。詳細については、API リファレンスを参照してください。

ソース PDF ファイルを指定する: ウォーターマークを付けたい PDF を指す FileInfo オブジェクトを作成します。

FileInfo fileInfo = new FileInfo();
fileInfo.setFilePath("input.pdf");

ファイルはリクエストの前に GroupDocs ストレージにアップロードされている必要があります。

画像透かしを設定する: 画像パス、透明度、スケール係数、回転、配置を定義します。

ImageWatermark imageWatermark = new ImageWatermark();
imageWatermark.setImagePath("watermark.png");
imageWatermark.setOpacity(0.5);
imageWatermark.setScaleFactor(0.3);
imageWatermark.setHorizontalAlignment(HorizontalAlignment.CENTER);
imageWatermark.setVerticalAlignment(VerticalAlignment.CENTER);
imageWatermark.setMargin(new Margin(10, 10, 10, 10));

これらの値を調整して目的の外観を実現してください。opacity は透明度を制御し、scaleFactor はページに対するサイズを決定します。

透かしオプションと出力パスを設定: ファイル情報と透かしを組み合わせて WatermarkOptions オブジェクトを作成します。

WatermarkOptions options = new WatermarkOptions();
options.setFileInfo(fileInfo);
options.setImageWatermark(imageWatermark);
options.setOutputPath("output.pdf");

outputPath は、サービスに生成された PDF を保存する場所を指示します。

リクエストを実行する: AddWatermarkRequest を作成し、API を呼び出します。成功またはエラーの応答を処理します。

AddWatermarkRequest request = new AddWatermarkRequest(options);
try {
    AddWatermarkResponse response = watermarkApi.addWatermark(request);
    System.out.println("Watermark added successfully. Output file: " + response.getPath());
} catch (Exception e) {
    System.err.println("Error adding watermark: " + e.getMessage());
}

実行後、透かしが付いた PDF は指定した場所にあります。

完全なコード例: JavaでPDFドキュメントに画像透かしを追加

以下の例は、クライアントの初期化から透かし入り PDF の保存までの完全な実装を示しています。

import com.groupdocs.cloud.watermark.api.WatermarkApi;
import com.groupdocs.cloud.watermark.client.ApiClient;
import com.groupdocs.cloud.watermark.model.AddWatermarkRequest;
import com.groupdocs.cloud.watermark.model.AddWatermarkResponse;
import com.groupdocs.cloud.watermark.model.FileInfo;
import com.groupdocs.cloud.watermark.model.ImageWatermark;
import com.groupdocs.cloud.watermark.model.Margin;
import com.groupdocs.cloud.watermark.model.WatermarkOptions;
import com.groupdocs.cloud.watermark.model.enums.HorizontalAlignment;
import com.groupdocs.cloud.watermark.model.enums.VerticalAlignment;

public class AddImageWatermarkExample {
    public static void main(String[] args) {
        // Initialize API client (replace with your actual credentials)
        ApiClient apiClient = new ApiClient("YOUR_CLIENT_ID", "YOUR_CLIENT_SECRET");
        WatermarkApi watermarkApi = new WatermarkApi(apiClient);

// Input PDF file information
        FileInfo fileInfo = new FileInfo();
        fileInfo.setFilePath("input.pdf");

// Image watermark configuration
        ImageWatermark imageWatermark = new ImageWatermark();
        imageWatermark.setImagePath("watermark.png");          // Path to watermark image
        imageWatermark.setOpacity(0.5);                        // 50% opacity
        imageWatermark.setScaleFactor(0.3);                    // 30% of page size
        imageWatermark.setRotationAngle(0);                    // No rotation
        imageWatermark.setHorizontalAlignment(HorizontalAlignment.CENTER);
        imageWatermark.setVerticalAlignment(VerticalAlignment.CENTER);
        imageWatermark.setMargin(new Margin(10, 10, 10, 10));  // 10 points margin on all sides

// Watermark options
        WatermarkOptions options = new WatermarkOptions();
        options.setFileInfo(fileInfo);
        options.setImageWatermark(imageWatermark);
        options.setOutputPath("output.pdf"); // Resulting PDF with watermark

// Create request and call API
        AddWatermarkRequest request = new AddWatermarkRequest(options);
        try {
            AddWatermarkResponse response = watermarkApi.addWatermark(request);
            System.out.println("Watermark added successfully. Output file: " + response.getPath());
        } catch (Exception e) {
            System.err.println("Error adding watermark: " + e.getMessage());
            e.printStackTrace();
        }
    }
}

注: このコード例はコア機能を示しています。プロジェクトで使用する前に、ファイルパス（input.pdf、watermark.png、output.pdf）を実際のファイルの場所に合わせて更新し、必要なすべての依存関係が正しくインストールされていることを確認し、開発環境で徹底的にテストしてください。問題が発生した場合は、公式ドキュメントをご参照いただくか、サポートチームにお問い合わせください。

cURL と REST API を使用した PDF ドキュメントへの画像透かしの適用

以下は、Javaコードを書かずに同じ結果を得るために cURL で使用できる REST 呼び出しです。

アクセストークンを取得する

curl -X POST "https://api.groupdocs.cloud/v2.0/auth/token" \
     -H "Content-Type: application/json" \
     -d '{"client_id":"YOUR_CLIENT_ID","client_secret":"YOUR_CLIENT_SECRET"}'

レスポンスには、後続の呼び出しで使用される access_token が含まれています。

ソースPDFをアップロード

curl -X POST "https://api.groupdocs.cloud/v2.0/storage/upload?path=input.pdf" \
     -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
     -F "file=@/path/to/input.pdf"

ウォーターマーク画像をアップロード

curl -X POST "https://api.groupdocs.cloud/v2.0/storage/upload?path=watermark.png" \
     -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
     -F "file=@/path/to/watermark.png"

画像の透かしを追加

curl -X POST "https://api.groupdocs.cloud/v2.0/watermark/add" \
     -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
     -H "Content-Type: application/json" \
     -d '{
           "fileInfo": { "filePath": "input.pdf" },
           "imageWatermark": {
               "imagePath": "watermark.png",
               "opacity": 0.5,
               "scaleFactor": 0.3,
               "horizontalAlignment": "Center",
               "verticalAlignment": "Center",
               "margin": { "top": 10, "right": 10, "bottom": 10, "left": 10 }
           },
           "outputPath": "output.pdf"
         }'

このリクエストは Java のコードロジックと同様で、同じ不透明度、スケーリング、配置設定を適用します。

透かし入りPDFをダウンロード

curl -X GET "https://api.groupdocs.cloud/v2.0/storage/download?path=output.pdf" \
     -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
     -o output.pdf

リクエストボディとサポートされているパラメータの詳細については、公式 API ドキュメントをご覧ください。

インストールと構成 GroupDocs.Watermark Cloud SDK for Java

Maven 依存関係を pom.xml に追加してください（または同等の Gradle スニペットを使用してください）。このライブラリは Maven Central にホストされています。


    com.groupdocs
    groupdocs-watermark-cloud
    23.8

有効な GroupDocs Cloud アカウントも必要です。Client ID と Client Secret は GroupDocs ポータルから取得してください。SDK がクラウドサービスと通信するため、追加のランタイムインストールは不要です。

PDF ドキュメントの画像透かしオプションの微調整

SDK は、透かしの視覚的外観を制御できる複数のプロパティを提供します。

不透明度の調整

imageWatermark.setOpacity(0.75); // 75% opacity for a more visible watermark

不透明度の値は 0.0（完全に透明）から 1.0（完全に不透明）までです。

スケール係数の変更

imageWatermark.setScaleFactor(0.5); // Watermark occupies 50% of the page width

スケール係数は、ページの寸法に対する透かしのサイズを決定します。

配置と余白の設定

imageWatermark.setHorizontalAlignment(HorizontalAlignment.RIGHT);
imageWatermark.setVerticalAlignment(VerticalAlignment.BOTTOM);
imageWatermark.setMargin(new Margin(20, 20, 20, 20));

これらの設定は、ウォーターマークを右下隅に20ポイントの余白で配置します。

構成可能なプロパティの完全な一覧については、API リファレンスを参照してください。

結論

Java で PDF ドキュメントに画像透かしを追加することは、GroupDocs.Watermark Cloud SDK for Java を使用すれば簡単です。SDK は低レベルの PDF 操作をすべて処理し、透明度、スケーリング、位置指定といった視覚的な側面に集中できるようにします。ネイティブな Java 実装でも、クラウドベースの cURL ワークフローでも、パフォーマンスを犠牲にすることなく同じ高品質な結果が得られます。製品版で使用する際は適切なライセンスを取得することを忘れないでください。価格情報は製品ページに掲載されており、評価用には一時ライセンスページを利用できます。

よくある質問

Javaで品質を失わずにPDFに画像の透かしを追加する方法は？
scaleFactor プロパティを使用して、ページに対する透かしのサイズを指定し、元のPDFの DPI を保持します。SDK は PDF の解像度を維持するため、ズームレベルに関係なく透かしは鮮明に表示されます。
同じPDFに複数の透かしを追加できますか？
はい。異なる設定の ImageWatermark オブジェクトを個別に作成し、addWatermark を複数回呼び出すか、リクエスト内のリストに追加して順番に適用します。
透かしでサポートされている画像形式は何ですか？
API は一般的な画像タイプを受け入れます。たとえば PNG、JPG、BMP、GIF および TIFF です。PNG はロスレス品質と透過サポートのために推奨されます。
透かしを適用する前にプレビューする方法はありますか？
GroupDocs.Watermark Cloud SDK for Java を使用して、透かし付きの一時的な PDF を生成し、レビュー用にダウンロードできます。これは、出力パスを一時的な場所に指定した同じ addWatermark 呼び出しを使用します。

pdf manipulation on Document Processing REST APIs | GroupDocs Cloud

REST を使用して Node.JS で PDF から注釈オブジェクトを削除する

REST を使用して Node.JS で PDF から注釈オブジェクトを削除する完全な動作例

cURL を使用した REST API で PDF アノテーションを削除する

REST と Node.JS で PDF からアノテーション オブジェクトを削除する方法

インストールと構成 GroupDocs.Annotation Cloud SDK for Node.js

アノテーション削除オプションと設定

REST を使用した PDF アノテーションの削除に関するベストプラクティス

よくある質問

Further Reading

Node.JSでPDFをマージする

開始する前に: 前提条件とインストール

Node.JS で PDF をマージするステップバイステップガイド

ステップ 1: SDK のインストールと必要なクラスのインポート

ステップ 2: GroupDocs の認証情報を設定する

ステップ 3: 結合する PDF ファイルを定義する

ステップ 4: マージ オプションを設定

ステップ 5: マージ操作を実行する

Node.JS で PDF をマージする完全実装例

cURL を使用した REST API による PDF の結合

マージ オプションの設定

PDF のマージに関するパフォーマンス上の考慮事項

よくある質問

さらに読む

JavaでPDFドキュメントに画像の透かしを追加する

JavaでPDFドキュメントに画像透かしを追加する5ステップ

完全なコード例: JavaでPDFドキュメントに画像透かしを追加

cURL と REST API を使用した PDF ドキュメントへの画像透かしの適用

インストールと構成 GroupDocs.Watermark Cloud SDK for Java

PDF ドキュメントの画像透かしオプションの微調整

不透明度の調整

スケール係数の変更

配置と余白の設定

結論

よくある質問

さらに読む

REST と Node.JS で PDF からアノテーションオブジェクトを削除する方法

ステップ 4: マージオプションを設定

マージオプションの設定