nodejs rest api 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でRESTを使用してExcelシートを編集する

Fri, 02 Oct 2026 14:32:02 +0000

スプレッドシートの更新を自動化することは、データ駆動型のウェブサービスやレポートパイプラインを構築する際によくあるニーズです。GroupDocs.Editor Cloud SDK for Node.js を使用すると、数行のコードだけで REST を介して Node.js で Excel ファイルを編集できます。このチュートリアルでは、SDK の設定方法、XLSX ワークブックの読み込み、セルの変更、変更の保存、そして生の cURL 呼び出しを使用して同じ結果を得る方法を紹介します。また、主要な機能、構成オプション、パフォーマンス上の考慮点についても説明し、Excel 編集を効率的に統合できるよう支援します。

Node.js を使用した REST で Excel ファイルを編集する - 5 ステップガイド

SDK をインストールし、認証情報を設定する: CLIENT_ID と CLIENT_SECRET を設定して、ライブラリが GroupDocs Cloud と認証できるようにします。

const CLIENT_ID = "YOUR_CLIENT_ID";
const CLIENT_SECRET = "YOUR_CLIENT_SECRET";

const config = new GroupDocsEditorCloud.Configuration(CLIENT_ID, CLIENT_SECRET);
const editApi = new GroupDocsEditorCloud.EditApi(config);

Excelブックを編集用にロードする: EditDocumentRequest を使用して、クラウドストレージに保存されているファイルを開きます。

const editRequest = new GroupDocsEditorCloud.EditDocumentRequest({
    fileInfo: new GroupDocsEditorCloud.FileInfo({ filePath: "input.xlsx" })
});
const editResult = await editApi.editDocument(editRequest);

最初のワークシートを取得し、対象セルを特定する: SDK はワークシートとセルを含む document オブジェクトを返します。

const worksheet = editResult.document.worksheets[0];
let targetCell = worksheet.cells.find(c => c.rowIndex === 0 && c.columnIndex === 0);

セルの値を更新または作成: セル A1 の内容を変更します（存在しない場合は追加します）。

if (!targetCell) {
    targetCell = new GroupDocsEditorCloud.Cell({
        rowIndex: 0,
        columnIndex: 0,
        value: "Edited via GroupDocs Editor Cloud"
    });
    worksheet.cells.push(targetCell);
} else {
    targetCell.value = "Edited via GroupDocs Editor Cloud";
}

編集したワークブックをストレージに保存: outputPath を指定し、saveDocument を呼び出します。

const saveOptions = new GroupDocsEditorCloud.SaveOptions({ outputPath: "output.xlsx" });
const saveRequest = new GroupDocsEditorCloud.SaveDocumentRequest({
    documentId: editResult.documentId,
    document: editResult.document,
    saveOptions: saveOptions
});
await editApi.saveDocument(saveRequest);

クラスとメソッドの完全な一覧については、API リファレンスをご覧ください。

REST を使用した Node.js での Excel ファイル編集 - 完全なコード例

次の例は、GroupDocs.Editor Cloud SDK を使用して REST 経由で Node.js で Excel ファイルを編集する方法を示しています。

const GroupDocsEditorCloud = require("@groupdocs/editor-cloud");

// Replace with your actual GroupDocs Cloud credentials
const CLIENT_ID = "YOUR_CLIENT_ID";
const CLIENT_SECRET = "YOUR_CLIENT_SECRET";

// Paths for the source Excel file and the edited result
const INPUT_FILE_PATH = "input.xlsx";
const OUTPUT_FILE_PATH = "output.xlsx";

async function editExcel() {
    // Configure the SDK
    const config = new GroupDocsEditorCloud.Configuration(CLIENT_ID, CLIENT_SECRET);
    const editApi = new GroupDocsEditorCloud.EditApi(config);

// 1. Load the Excel workbook for editing
    const editRequest = new GroupDocsEditorCloud.EditDocumentRequest({
        fileInfo: new GroupDocsEditorCloud.FileInfo({
            filePath: INPUT_FILE_PATH
        })
    });

const editResult = await editApi.editDocument(editRequest);
    const documentId = editResult.documentId;
    const document = editResult.document;

// 2. Retrieve the first worksheet
    const worksheet = document.worksheets[0];

// 3. Update cell A1 (rowIndex = 0, columnIndex = 0) with a new value
    let targetCell = worksheet.cells.find(c => c.rowIndex === 0 && c.columnIndex === 0);
    if (!targetCell) {
        targetCell = new GroupDocsEditorCloud.Cell({
            rowIndex: 0,
            columnIndex: 0,
            value: "Edited via GroupDocs Editor Cloud"
        });
        worksheet.cells.push(targetCell);
    } else {
        targetCell.value = "Edited via GroupDocs Editor Cloud";
    }

// 4. Save the edited workbook back to storage
    const saveOptions = new GroupDocsEditorCloud.SaveOptions({
        outputPath: OUTPUT_FILE_PATH
    });

const saveRequest = new GroupDocsEditorCloud.SaveDocumentRequest({
        documentId: documentId,
        document: document,
        saveOptions: saveOptions
    });

const saveResult = await editApi.saveDocument(saveRequest);
    console.log(`Edited file saved to: ${saveResult.path}`);
}

// Execute the edit operation
editExcel().catch(error => {
    console.error("Error during Excel editing:", error);
});

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

cURL を使用した Node.js の REST API で XLSX シートを更新

以下は、生の HTTP 呼び出しを使用した同じ操作の簡単な手順です。プレースホルダーの値を実際の認証情報とファイル名に置き換えてください。

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

curl -X POST "https://api.groupdocs.cloud/v2.0/connect/token" \
        -H "Content-Type: application/x-www-form-urlencoded" \
        -d "client_id=YOUR_CLIENT_ID&client_secret=YOUR_CLIENT_SECRET&grant_type=client_credentials"

レスポンスには access_token が含まれます。

ソースのXLSXファイルをアップロード

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

ワークブックを編集 (セル A1 を変更)

curl -X POST "https://api.groupdocs.cloud/v2.0/editor/edit" \
     -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
     -H "Content-Type: application/json" \
     -d '{
           "fileInfo": { "filePath": "input.xlsx" },
           "options": {
               "cells": [
                   { "rowIndex": 0, "columnIndex": 0, "value": "Edited via GroupDocs Editor Cloud" }
               ]
           }
         }'

編集されたファイルをダウンロード

curl -X GET "https://api.groupdocs.cloud/v2.0/storage/file/output.xlsx" \
        -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
        -o output.xlsx

リクエストペイロードの詳細については、公式 API ドキュメントをご覧ください。

GroupDocs.Editor Cloud SDK for Node.js の前提条件とセットアップ

SDKの使用を開始するには、Node.js 14 以降とGroupDocs Cloudアカウントが必要です。

npm install groupdocs-editor-cloud

最新パッケージはリリースページからダウンロードできます。インストール後、GroupDocs Cloud ダッシュボードで client_id と client_secret を作成し、安全に保管してください。

GroupDocs.Editor Cloud SDK for Node.js が Excel ワークシートの変更に最適な理由

完全なXLSXサポート - 数式、スタイル、データ検証を保持しながら、ブックを読み込み、編集、保存します。
セルレベルの編集 - 個々のセル、行、列にプログラムでアクセスでき、レポートやダッシュボードの更新に最適です。
クラウドストレージ統合 - ローカルにダウンロードせずに、GroupDocs Cloudに保存されたファイルを直接操作できます。
安全なREST通信 - すべての操作はHTTPS上で行われ、SDKがトークン管理を代行します。

さらに詳しくは、ドキュメントをご参照ください。

GroupDocs.Editor Cloud の Excel 編集オプションの微調整

SDK は、編集されたワークブックの保存方法を制御できる複数のオプションを提供します。

const saveOptions = new GroupDocsEditorCloud.SaveOptions({
    outputPath: "output.xlsx",
    // You can also set compression level, password protection, etc.
});

outputPath - クラウドストレージ内の保存先パス。
compressionLevel - 大きなワークブックのファイルサイズを削減します（APIリファレンスで利用可能）。
password - 必要に応じて、生成されたファイルをパスワードで保護します。

プロジェクトのセキュリティとパフォーマンスの要件に合わせてこれらの設定を調整してください。

REST を使用した XLSX ワークブックの編集に関するパフォーマンス上の考慮事項

構成オブジェクトを再利用する - 各リクエストごとに新しい Configuration を作成するとオーバーヘッドが発生します。アプリケーションのライフタイム全体で単一のインスタンスを保持してください。
セルの更新をバッチ処理する - 多くのセルを変更する必要がある場合、配列にまとめて、複数の呼び出しではなく単一の編集リクエストを送信してください。
ワークシートのサイズを制限する - 非常に大きなワークシートはメモリ消費を増加させます。可能であればデータを複数のシートに分割することを検討してください。
不要な保存を避ける - 必要な変更がすべて適用された後にのみ saveDocument を呼び出し、I/O 操作を削減してください。

結論

Node.js で REST を介して Excel ファイルを編集することは、GroupDocs.Editor Cloud SDK for Node.js を使用すると簡単になります。数回の API 呼び出しまたはシンプルな cURL コマンドだけで、プログラムからワークブックをロードし、セルを変更し、結果を保存できます。SDK のクラウドベースアーキテクチャにより、ローカルの Office インストールが不要になり、アプリケーションのワークロードに合わせてスケールします。本番環境での導入には、使用パターンに合ったライセンスを購入してください。また、一時ライセンスページからテスト用の一時ライセンスを取得することもできます。今日から Excel 編集を統合し、データ処理パイプラインを効率化しましょう。

よくある質問

Node.js で REST を使用して、カスタム HTTP コードを書かずに Excel ファイルを編集するにはどうすればよいですか？
GroupDocs.Editor Cloud SDK for Node.js を使用すると、REST 呼び出しを抽象化し、シンプルなメソッド呼び出しだけで Node.js から REST 経由で Excel ファイルを編集できます。

REST api Node.js を使用して大きなファイルの XLSX シートを更新できますか？
はい。SDK はデータをストリーミングし、バッチ更新をサポートするため、大規模なブックに適しています。compressionLevel とバッチセル変更を調整してパフォーマンスを向上させてください。

Excel ワークシートをプログラムで Node.js から変更する最適な方法は何ですか？
editDocument が返す worksheet と cell オブジェクトを使用します。これにより、Node.js 環境を離れることなく、行、列、セルの値を完全に制御できます。

価格とライセンス情報はどこで確認できますか？
価格層や評価用の一時ライセンスを含むすべてのライセンス詳細は、一時ライセンスページで利用できます。

nodejs rest api 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でRESTを使用してExcelシートを編集する

Node.js を使用した REST で Excel ファイルを編集する - 5 ステップガイド

REST を使用した Node.js での Excel ファイル編集 - 完全なコード例

cURL を使用した Node.js の REST API で XLSX シートを更新

GroupDocs.Editor Cloud SDK for Node.js の前提条件とセットアップ

GroupDocs.Editor Cloud SDK for Node.js が Excel ワークシートの変更に最適な理由

GroupDocs.Editor Cloud の Excel 編集オプションの微調整

REST を使用した XLSX ワークブックの編集に関するパフォーマンス上の考慮事項

結論

よくある質問

もっと読む

nodejs rest api 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でRESTを使用してExcelシートを編集する

Node.js を使用した REST で Excel ファイルを編集する - 5 ステップ ガイド

REST を使用した Node.js での Excel ファイル編集 - 完全なコード例

cURL を使用した Node.js の REST API で XLSX シートを更新

GroupDocs.Editor Cloud SDK for Node.js の前提条件とセットアップ

GroupDocs.Editor Cloud SDK for Node.js が Excel ワークシートの変更に最適な理由

GroupDocs.Editor Cloud の Excel 編集オプションの微調整

REST を使用した XLSX ワークブックの編集に関するパフォーマンス上の考慮事項

結論

よくある質問

もっと読む

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

Node.js を使用した REST で Excel ファイルを編集する - 5 ステップガイド