開発者にとって素晴らしいニュースです。まったく新しい GroupDocs.Annotation Cloud 19.5 が導入されました。私たちは、GroupDocs.Annotation Cloud REST API をより簡略化して使いやすく進化させることに取り組んでいます。これを念頭に置いて、このバージョンでは必要な変更を加えました。新しい API は、より少ないメソッドとオプションでより最適化されています。その内部アーキテクチャは、テキストと図ベースの注釈操作をサポートするドキュメントと画像の注釈ツールを構築するための高速かつ信頼性の高い処理のために刷新されました。また、API にはクラウド ストレージを操作するためのメソッドも含まれています。そのため、別の API を使用する代わりに、GroupDocs.Annotation Cloud REST API を直接使用してストレージ操作を実行できます。

このリリースで行われたすべての新機能/機能強化についてのアイデアを得るには、詳細な このバージョンのリリースノート を確認してください。

重大な変更

新しい API バージョン

API バージョン V2 は 19.5 バージョンで導入されましたが、V1 は引き続き利用可能です。

認証

このリリースでは JWT(JSON Web Token) 認証が導入され、OAuth2 および URL 署名認証方式は廃止されました。

アノテーションAPI

テキストおよび図ベースの注釈をすべての一般的な形式のドキュメントと画像に適用するための簡素化された API メソッド。

ストレージAPI

ファイル API – クラウド ストレージにファイルをアップロード、ダウンロード、コピー、移動、削除するためのメソッドを導入しました: 入力ドキュメントとレンダリング結果

フォルダー API - クラウド ストレージでフォルダーを作成、コピー、移動、削除するためのメソッドを導入しました

Storage API - ストレージ情報とファイル情報を取得するメソッドを導入しました

ドキュメントに注釈を追加する

ここでは、GroupDocs.Annotation Cloud V2 API バージョンがどのように機能し、V1 と異なるのかを説明します。次の手順に従って、GroupDocs.Annotation Cloud SDK for .NET を使用して Word 文書に注釈を追加します。

• ソースドキュメントをストレージにアップロードする
• ソース文書に注釈を追加する

この例ではクラウド ストレージからドキュメントを処理するため、ソース ドキュメントをクラウド ストレージにアップロードする必要があります。このリリースでは、ファイル ストレージ操作のための File API を導入しました。ファイルをストレージにアップロードするには、GroupDocs.Storage Cloud API メソッドの代わりに Annotation V2 API バージョンの UploadFile メソッドを使用します。

using System;
using System.IO;
using GroupDocs.Annotation.Cloud.Sdk.Api;
using GroupDocs.Annotation.Cloud.Sdk.Client;
using GroupDocs.Annotation.Cloud.Sdk.Model.Requests;

namespace GroupDocs.Annotation.Cloud.Examples.CSharp
{
	// ファイルをアップロードする
	class Upload_File
	{
		public static void Run()
		{
			var configuration = new Configuration(Common.MyAppSid, Common.MyAppKey);
			var apiInstance = new FileApi(configuration);

			try
			{
				// ローカル/ディスクからIOStreamでファイルを開きます。
				var fileStream = File.Open("..\\..\\..\\Data\\Annotationdocs\\one-page.docx", FileMode.Open);

				var request = new UploadFileRequest("Annotationdocs/one-page1.docx", fileStream, Common.MyStorage);

				var response = apiInstance.UploadFile(request);
				Console.WriteLine("Expected response type is FilesUploadResult: " + response.Uploaded.Count.ToString());
			}
			catch (Exception e)
			{
				Console.WriteLine("Exception while calling FileApi: " + e.Message);
			}
		}
	}
}

19.5 バージョンでは、以下のサンプルコードに示すように、アノテーションのインポートの PUT メソッドが POST メソッドに変更されました。

V1.1 の例

//TODO: https://dashboard.groupdocs.cloud で AppSID と AppKey を取得します (無料の登録が必要です)。
var configuration = new Configuration
{
    AppSid = Sid,
    AppKey = Key
};

var apiInstance = new AnnotationApi(configuration);


try
{
    List<AnnotationInfo> annotations = new List<AnnotationInfo>();
    AnnotationInfo annotation = new AnnotationInfo
    {
        AnnotationPosition = new Point(852, 154.31),
        Replies = new[]
        {
                      new AnnotationReplyInfo {Message = "reply text", RepliedOn = DateTime.Now, UserName = "Admin"},
                      new AnnotationReplyInfo
                      {
                          Message = "reply2 text",
                          RepliedOn = DateTime.Now,
                          UserName = "Commentator"
                      }
                  },
        Box = new Rectangle((float)173.29, (float)154.31, (float)142.5, 9),
        PageNumber = 0,
        SvgPath =
            "[{\"x\":173.2986,\"y\":687.5769},{\"x\":315.7985,\"y\":687.5769},{\"x\":173.2986,\"y\":678.5769},{\"x\":315.7985,\"y\":678.5769}]",
        Type = AnnotationType.Text,
        CreatorName = "Anonym A."
    };
    annotations.Add(annotation);
    PutExportRequest request = new PutExportRequest()
    {
        Name ="Annotated.pdf",
        Folder=null,
        Password=null,
        Body=annotations,
        
    };
    // 注釈をドキュメントに挿入/エクスポートします。
    var response = apiInstance.PutExport(request);
    Debug.Print("Document Processsed and stream length: " + response.Length);

}
catch (Exception e)
{
    Debug.Print("Exception when inserting Annotation to document: " + e.Message);
}

V2.0の例

using System;
using GroupDocs.Annotation.Cloud.Sdk.Api;
using GroupDocs.Annotation.Cloud.Sdk.Client;
using GroupDocs.Annotation.Cloud.Sdk.Model;
using GroupDocs.Annotation.Cloud.Sdk.Model.Requests;

namespace GroupDocs.Annotation.Cloud.Examples.CSharp
{
	// 注釈の投稿/追加
	class Add_Annotation
	{
		public static void Run()
		{
			var configuration = new Configuration(Common.MyAppSid, Common.MyAppKey);
			var apiInstance = new AnnotateApi(configuration);

			try
			{
				// リクエストを設定します。
				var request = new PostAnnotationsRequest()
				{
					filePath = "Annotationdocs\\ten-pages.docx",
					annotations = new System.Collections.Generic.List<AnnotationInfo>() {
						new AnnotationInfo
						{
							AnnotationPosition = new Point { X = 852, Y = 59.388262910798119 },
							Box = new Rectangle { X = 375.89276123046875, Y = 59.388263702392578, Width = 88.7330551147461, Height = 37.7290153503418 },
							PageNumber = 0,
							PenColor = 1201033,
							PenStyle = 0,
							PenWidth = 1,
							Type = AnnotationInfo.TypeEnum.Area,
							CreatorName = "Anonym A."
						}
					}
				};
				apiInstance.PostAnnotations(request);
				Console.WriteLine("Expected response type is void: Annotation added.");
			}
			catch (Exception e)
			{
				Console.WriteLine("Exception while calling Annotation AnnotateApi: " + e.Message);
			}
		}
	}
}

フィードバックを共有する

あなたのフィードバックは重要です! GroupDocs.Annotation Cloud REST API の新しいバージョンに関するご意見をお気軽に コメント してください。これは、API を継続的に改善および改良するのに役立ちます。