ドキュメントアノテーション Java Cloud REST API

GroupDocs.Annotation Cloud SDK for Java は、サードパーティ製ソフトウェアをインストールすることなく動作するクラウドドキュメントアノテーター Java アプリを構築するのに役立ちます。これは GroupDocs.Annotation Cloud REST APIs のラッパーです。

ドキュメントアノテーションの機能

• クラウドドキュメントに単一または複数のアノテーションを追加します。
• クラウドに保存されたドキュメントに直接アノテーションを追加します。
• テキスト、画像、形状を含むさまざまなアノテーションタイプをサポートします。
• 色、サイズ、位置などのアノテーションプロパティをカスタマイズします。
• PDF、Word、Excel、PowerPoint、画像などの複数のドキュメント形式にアノテーションを追加します。

ドキュメント管理機能

• ドキュメントのレンダリング: ドキュメントを PDF、画像、または HTML 形式に変換して表示または印刷します。
• ドキュメントのプレビュー: ドキュメントのページの画像表現を生成してプレビューします。
• アノテーションの削除: 特定のアノテーションを削除するか、ドキュメントからすべてのアノテーションを削除します。
• アノテーションの抽出: ドキュメントからすべてのアノテーションを JSON オブジェクトのリストとして取得します。

ファイル＆ストレージ管理

• ファイル API を使用する: クラウドストレージ内のファイルをアップロード、ダウンロード、コピー、移動、および削除します。
• フォルダ API を使用する: クラウドストレージ内のフォルダを整理および管理します（作成、移動、削除）。
• ストレージ API を使用する: クラウドストレージリソースにアクセスして管理し、ストレージの詳細やファイル情報を取得します。
• サポートされているファイル形式を取得する: アノテーションにサポート

されているファイル形式のリストを取得します。

• ファイル情報: クラウド内のファイルに関する詳細情報を取得します（サイズ、形式、メタデータなど）。

ドキュメント情報＆処理

• ドキュメント情報を取得: メタデータ、テキストコンテンツ、アノテーションなど、詳細なドキュメント情報を取得します。
• ページを取得: ドキュメント内のページのリストにアクセスし、サイズや向きなどの詳細を取得します。
• アノテーション情報: アノテーションの詳細情報にアクセスします（タイプ、位置、コンテンツなど）。
• アノテーションオプション: ページ選択、位置、スタイリングなど、さまざまなアノテーションオプションを設定します。
• 高度な使用: グループ化や順序設定など、アノテーションを管理するための高度な機能を利用します。

サポートされているアノテーションタイプ

• エリアアノテーション: クラウドドキュメント内の特定の矩形エリアをハイライトしてアノテートします。
• 矢印アノテーション: クラウドドキュメントのページ上の特定のコンテンツを指摘するための矢印を描画します。
• 距離アノテーション: クラウドドキュメント内の2つのオブジェクトまたはポイント間の距離を測定してアノテートします。
• 楕円アノテーション: ドキュメント内の特定のコンテンツをハイライトしてアノテートするための楕円形を使用します。
• 画像アノテーション: ドキュメントのコンテンツの上に画像を重ねてアノテートします。
• リンクアノテーション: 外部リソースへのハイパーリンクアノテーションを追加します。
• ポイントアノテーション: ドキュメント内の特定のポイントに注釈を追加します。
• ポリラインアノテーション: 自由な線や形を描いてコンテンツをアノテートしてハイライトします。
• リソース編集アノテーション: 黒い長方形で機密テキストを編集します。
• テキストフィールドアノテーション: カラーフレーム内にテキストコメントを追加します。
• テキストハイライトアノテーション: テキストをハイライトしてコメントを追加し、特定のコンテンツに注目を集めます。
• テキスト編集アノテーション: 選択したテキストを黒い長方形で隠して編集します。
• テキスト置換アノテーション: 元のテキストを新しいフラグメントに置き換えるアノテーションを追加します。
• テキスト取り消し線アノテーション: 削除するテキストに取り消し線を引いてマークします。
• テキスト下線アノテーション: テキストに下線を引いて強調します。
• 透かしアノテーション: ドキュメントの上に透かしテキストアノテーションを追加します。
• スクイグリーアノテーション: 波線を使用してテキストを強調します。

API 固有の機能

• 直接アノテーションを追加: ダウンロードすることなくドキュメントにアノテーションを追加します。
• 公開 API サンプル: API 機能を利用するためのサンプルコードとドキュメントにアクセスします。

サポートされているクラウドアノテーションドキュメント形式

• Microsoft Word®: DOC, DOCX, DOCM, DOT, DOTX, DOTM, RTF, TXT
• OpenOffice Writer®: ODT, OTT
• Microsoft Excel®: XLS, XLSX, XLSB
• Microsoft PowerPoint®: PPT, PPTX, PPSX
• OpenOffice Impress®: ODP, OTP
• Microsoft Visio®: VSD, VDX, VSS, VSDM
• Microsoft Outlook®: MSG, EML, EMLX
• AutoCAD®: CAD
• 画像: DJVU, JPEG, TIFF, BMP, GIF (アニメーションなしの静止画像)
• 医療画像: DICOM
• マークアップ: HTML, MHTML
• 固定レイアウト: PDF
• メタファイル: EMF, WMF

要件

• Java バージョン: API クライアントライブラリの構築には Java 1.7 以上が必要です。
• ビルドツール: 依存関係を管理し、プロジェクトをビルドするために Maven が必要です。

前提条件

• GroupDocs Cloud アカウント: GroupDocs.Annotation Cloud SDK for Java を使用するには、GroupDocs Cloud にアカウントを登録する必要があります。
• クライアント ID & クライアントシークレット: 登録後、クラウドダッシュボード でクライアント ID とクライアントシークレットを確認または作成する必要があります。
• 無料のクォータ: GroupDocs Cloud は新規ユーザー向けに無料のクォータを提供しています。詳細については、GroupDocs Cloud の価格 をご覧ください。

Maven から GroupDocs.Annotation-Cloud をインストール

GroupDocs.Annotation Cloud SDK for Java をインストールするには、アプリケーションの pom.xml ファイルに GroupDocs Cloud リポジトリを追加する必要があります。

<repository>
    <id>repository.groupdocs.cloud</id>
    <name>repository.groupdocs.cloud</name>
    <url>https://releases.groupdocs.cloud/java/repo/</url>
</repository>

ソースからインストール

API クライアントライブラリをソースコードからインストールするには、次の手順に従います。

• ローカル Maven リポジトリにインストール: ライブラリをローカル Maven リポジトリにインストールするには、ターミナルで次のコマンドを実行します。

mvn clean install

• リモート Maven リポジトリにデプロイ: リモート Maven リポジトリにデプロイする場合は、リポジトリ設定を構成し、次のコマンドを実行します。

mvn clean deploy

リモートリポジトリへのデプロイに関する詳細については、OSSRH ガイド を参照してください。

Maven ユーザー

Maven ユーザーの場合、プロジェクトの pom.xml ファイルに GroupDocs.Annotation Cloud SDK for Java を依存関係として追加できます。

<dependency>
    <groupId>com.groupdocs</groupId>
    <artifactId>groupdocs-annotation-cloud</artifactId>
    <version>22.2</version>
    <type>pom</type>
</dependency>

はじめに

GroupDocs.Annotation Cloud SDK for Java を使い始めるには、次の手順に従います。

1. SDK をインストール: 上記の手順に

従って SDK をインストールします（Maven を使用するか、ソースからインストールします）。 2. 設定: GroupDocs Cloud ダッシュボードから取得したクライアント ID とクライアントシークレットを使用して設定を行います。 3. サンプルコード: アプリケーションにサンプルコードを実装してアノテーションを追加し、ドキュメント情報を抽出し、ファイルやフォルダを管理します。 4. ドキュメント: クイックスタートガイドと API ドキュメントを参照して、詳細な使用例や追加情報を確認します。

認証 & 認可

GroupDocs.Annotation Cloud SDK for Java は、認証と認可に OAuth 2.0 を使用します。以下の詳細が提供されています。

• 認証タイプ: OAuth 2.0
• フロー: アプリケーションベースの認証
• 認証 URL: https://api.groupdocs.cloud/connect/token
• トークンの有効期間: 1日（デフォルト）

JWT

GroupDocs.Annotation Cloud SDK は、安全な API アクセスのために JSON Web Tokens (JWT) を使用します。

• トークンタイプ: OAuth 2.0 JWT (JSON Web Token)
• 認証 URL: トークンは https://api.groupdocs.cloud/connect/token エンドポイントを使用して生成されます。
• トークン有効期限: デフォルトのトークンの有効期間は 1 日であり、安全で時間制限のある API へのアクセスを保証します。

これらの詳細は、GroupDocs.Annotation Cloud SDK for Java の設定と使用に関する包括的なガイドを提供し、必須の要件、インストール手順、およびセキュリティ設定をカバーしています。

以下は、提供されたコンテンツから抽出された最も売り込み可能なコードスニペットの2つです。これらのスニペットは、アノテーション機能をアプリケーションに統合したいと考えている潜在的なユーザーにアピールする重要な機能を示しています。

サンプルクラウド Java コードでポイントアノテーションを追加する

このスニペットは、GroupDocs.Annotation Cloud SDK for Java を使用してドキュメントにポイントアノテーションを追加する方法を示しています。ポイントアノテーションは、ドキュメント内の特定のポイントにコメントや注釈を追加するのに役立ちます。

// 完全なサンプルとデータファイルについては、https://github.com/groupdocs-annotation-cloud/groupdocs-annotation-cloud-java-samples にアクセスしてください
String MyAppKey = ""; // AppKey と AppSID を https://dashboard.groupdocs.cloud から取得します
String MyAppSid = ""; // AppKey と AppSID を https://dashboard.groupdocs.cloud から取得します

Configuration configuration = new Configuration(MyAppSid, MyAppKey);
AnnotateApi apiInstance = new AnnotateApi(configuration);

// アノテーションを作成します。
AnnotationInfo[] annotations = new AnnotationInfo[1];
annotations[0] = new AnnotationInfo();

Point pt = new Point();
pt.setX(1.0);
pt.setY(1.0);
annotations[0].setAnnotationPosition(pt);

Rectangle r = new Rectangle();
r.setX(100.0);
r.setY(100.0);
r.setWidth(200.0);
r.setHeight(100.0);

annotations[0].setBox(r);
annotations[0].setPageNumber(0);
annotations[0].setType(TypeEnum.POINT);
annotations[0].setText("これはポイントアノテーションです");
annotations[0].setCreatorName("Anonym A.");

// リクエストオブジェクトを作成します。
FileInfo fileInfo = new FileInfo();
fileInfo.setFilePath("Annotationdocs\\one-page.docx");

AnnotateOptions options = new AnnotateOptions();
options.setFileInfo(fileInfo);
options.setAnnotations(Arrays.asList(annotations));
options.setOutputPath("Output/one-page-annotated.docx");

AnnotateRequest request = new AnnotateRequest(options);

// API メソッドを実行します。
AnnotationApiLink result = apiInstance.annotate(request);
System.out.println("AddPointAnnotation: Point Annotation added: " + result.getTitle());

サンプルクラウド Java コードでテキストハイライトアノテーションを追加する

このコードスニペットは、ドキュメントにテキストハイライトアノテーションを追加する方法を示しています。テキストのハイライトは、特にレビュー プロセスで一般的なアノテーション タスクであり、このスニペットはそれをプログラムで実行する方法を示しています。

// 完全なサンプルとデータファイルについては、https://github.com/groupdocs-annotation-cloud/groupdocs-annotation-cloud-java-samples にアクセスしてください
String MyAppKey = ""; // AppKey と AppSID を https://dashboard.groupdocs.cloud から取得します
String MyAppSid = ""; // AppKey と AppSID を https://dashboard.groupdocs.cloud から取得します

Configuration configuration = new Configuration(MyAppSid, MyAppKey);
AnnotateApi apiInstance = new AnnotateApi(configuration);

// アノテーションを作成します。
AnnotationInfo[] annotations = new AnnotationInfo[1];
annotations[0] = new AnnotationInfo();

Rectangle r = new Rectangle();
r.setX(100.0);
r.setY(100.0);
r.setWidth(300.0);
r.setHeight(50.0);

annotations[0].setBox(r);
annotations[0].setPageNumber(0);
annotations[0].setType(TypeEnum.TEXT_HIGHLIGHT);
annotations[0].setText("このテキストはハイライトされています");
annotations[0].setCreatorName("Anonym A.");

// リクエストオブジェクトを作成します。
FileInfo fileInfo = new FileInfo();
fileInfo.setFilePath("Annotationdocs\\sample.docx");

AnnotateOptions options = new AnnotateOptions();
options.setFileInfo(fileInfo);
options.setAnnotations(Arrays.asList(annotations));
options.setOutputPath("Output/sample-annotated.docx");

AnnotateRequest request = new AnnotateRequest(options);

// API メソッドを実行します。
AnnotationApiLink result = apiInstance.annotate(request);
System.out.println("AddTextHighlightAnnotation: Text Highlight Annotation added: " + result.getTitle());