Microsoft 365 用の統合アプリマニフェストを含む Office アドイン (プレビュー)

[アーティクル]
10/11/2023

この記事では、プレビュー段階の Microsoft 365 用統合アプリマニフェストについて説明します。 Office アドインマニフェストについて理解していることを前提としています。

ヒント

XML マニフェストの概要については、「 Office アドイン XML マニフェスト」を参照してください。
XML マニフェストに慣れている場合は、「 Microsoft 365 の統合マニフェストと XML マニフェストを比較する」を参照して、JSON 形式の統合マニフェストを簡単に把握できます。

Microsoft は、Microsoft 365開発者プラットフォームについて多くの改善を行っています。これらの機能強化により、Office アドインを含む、Microsoft 365 のすべての種類の拡張機能の開発、展開、インストール、および管理の一貫性が向上します。これらの変更は、既存のアドインと互換性があります。

取り組んでいる重要な改善点の 1 つは、Microsoft 365 用の JSON 形式の統合アプリマニフェストに基づいて、同じマニフェスト形式とスキーマを使用して、すべての Microsoft 365 拡張機能 (Teams Apps) に対して 1 つの配布単位を作成できることです。

注:

Microsoft 365 プラットフォームの任意の部分の拡張機能は、Teams アプリケーション自体を拡張しない場合でも、"Teams アプリ" と呼ばれるようになりました。

Microsoft 365 用の統合マニフェストを使用して、Windows でのみ実行される Outlook アドインを作成できるようにすることで、これらの目標に向けた重要な第一歩を踏み出しました。

注:

統合マニフェストはプレビューで利用でき、フィードバックに基づいて変更される場合があります。経験豊富なアドイン開発者には、それを試してみることをお勧めします。統合マニフェストは、運用環境のアドインでは使用しないでください。
統合マニフェストのプレビューバージョンでは、Outlook アドインのみがサポートされ、Microsoft 365 サブスクリプションからダウンロードされ、Windows にインストールされている Office でのみサポートされます。 Excel、PowerPoint、Word、およびその他のプラットフォームへのサポートの拡張に取り組んでいます。
統合マニフェストには、Office バージョン 2304 (ビルド 16320.00000) 以降が必要です。 Microsoft 365 サブスクリプションチャネルは "ベータ版" である必要があります。

ヒント

プレビュー統合マニフェストの使用を開始する準備はできましたか? 「 Microsoft 365 用の統合マニフェストを使用して Outlook アドインをビルドする (プレビュー)」から始めます。

統合マニフェストの主要なプロパティ

統合アプリマニフェストのプレビューバージョンに関するメインリファレンスドキュメントは、Teams のパブリック開発者プレビューアプリマニフェストスキーマにあります。この記事では、重要な基本マニフェストプロパティに関する情報を提供しますが、"extensions" プロパティのドキュメントは含まれていない場合があります。これは、Office アドインが統合マニフェストで構成されているプロパティです。そのため、この記事では、Teams アプリが Office アドインである (または含まれている) 場合の基本プロパティの意味について簡単に説明します。その後、"extensions" プロパティとその子孫プロパティに関する基本的なドキュメントが続きます。サンプルプレビュー統合マニフェストには、アドインの完全なサンプルマニフェストがあります。

基本プロパティ

次の表に示す各基本プロパティには、 Teams のパブリック開発者プレビューアプリマニフェストスキーマに関するより広範なドキュメントがあります。この表に含まれていない基本プロパティは、Office アドインには意味がありません。

JSON プロパティ	用途
"$schema"	マニフェストスキーマを識別します。
"manifestVersion"	マニフェストスキーマのバージョンです。
"id"	Teams アプリ/アドインの GUID。
"version"	Teams アプリ/アドインのバージョン。
"name"	Teams アプリ/アドインのパブリックの短い名前と長い名前。短い名前がアドインの作業ウィンドウの上部に表示されます。
"description"	Teams アプリ/アドインの短い説明と長い説明を公開します。
"developer"	Teams アプリ/アドインの開発者に関する情報。
"localizationInfo"	既定のロケールとその他のサポートされているロケールを構成します。
"validDomains"	「セーフドメインを指定する」を参照してください。
"webApplicationInfo"	Azure Active Directory で認識されている Teams アプリ/アドインの Web アプリを識別します。
"authorization"	アドインに必要な Microsoft Graphアクセス許可を識別します。

"extensions" プロパティ

"extensions" プロパティとその子孫プロパティに関するリファレンスドキュメントを完成させるために、一生懸命取り組んでいます。それまでの間、次に示すいくつかの基本的なドキュメントを示します。すべてのプロパティではなく、ほとんどのプロパティには、アドインの XML マニフェストに同等の要素 (または属性) があります。ほとんどの場合、XML 要素または属性に適用される説明と制限は、統合マニフェストで同等の JSON プロパティにも適用されます。「 Xml マニフェストと Microsoft 365 の統合マニフェストを比較する」の「拡張機能」プロパティセクションのテーブルは、JSON プロパティと同等の XML を判断するのに役立ちます。

JSON プロパティ	用途
"requirements.capabilities"	アドインをインストール可能にする必要がある要件セットを識別します。
"requirements.scopes"	アドインをインストールできる Office アプリケーションを識別します。たとえば、"メール" とは、アドインを Outlook にインストールできることを意味します。
"ribbons"	アドインがカスタマイズするリボン。
"ribbons.contexts"	アドインがカスタマイズするコマンドサーフェスを指定します。たとえば、"mailRead" や "mailCompose" などです。
"ribbons.tabs"	カスタムリボンタブを構成します。
"alternatives"	同等の COM アドイン、XLL、またはその両方との下位互換性を指定します。
"runtimes"	カスタム関数専用アドインや関数コマンドなど、UI がほとんどまたはまったくないさまざまな種類のアドインなど、アドインで使用される埋め込みランタイムを構成します。
"autoRunEvents"	指定したイベントのイベントハンドラーを構成します。

セーフドメインを指定する

マニフェストファイルには "validDomains" 配列があり、アドインの移動を許可するドメインを Office に伝えるために使用されます。「アドインウィンドウで開くドメインを指定する」で示されているように、Office on the webで実行する場合は、作業ウィンドウを任意の URL に移動できます。ただし、デスクトッププラットフォームでは、アドインがスタートページをホストするドメイン以外のドメインの URL に移動しようとすると、その URL は Office アプリケーションのアドインウィンドウの外側の新しいブラウザーウィンドウで開きます。

デスクトッププラットフォームでこの動作をオーバーライドするには、アドインウィンドウで開く各ドメインを、"validDomains" 配列で指定されたドメインの一覧に追加します。アドインがこの一覧にあるドメインの URL に移動しようとすると、Office on the web とデスクトップの Office の両方の作業ウィンドウで開きます。一覧にない URL に移動しようとすると、Office on desktop で、その URL が新しいブラウザーウィンドウ (アドイン作業ウィンドウの外側) で開きます。

プレビュー統合マニフェストのサンプル

アドインのプレビュー統合アプリマニフェストの例を次に示します。

{
  "$schema": "https://raw.githubusercontent.com/OfficeDev/microsoft-teams-app-schema/op/extensions/MicrosoftTeams.schema.json",
  "id": "00000000-0000-0000-0000-000000000000",
  "version": "1.0.0",
  "manifestVersion": "devPreview",
  "name": {
    "short": "Name of your app (<=30 chars)",
    "full": "Full name of app, if longer than 30 characters (<=100 chars)"
  },
  "description": {
    "short": "Short description of your app (<= 80 chars)",
    "full": "Full description of your app (<= 4000 chars)"
  },
  "icons": {
    "outline": "outline.png",
    "color": "color.png"
  },
  "accentColor": "#230201",
  "developer": {
    "name": "Contoso",
    "websiteUrl": "https://www.contoso.com",
    "privacyUrl": "https://www.contoso.com/privacy",
    "termsOfUseUrl": "https://www.contoso.com/servicesagreement"
  },
  "localizationInfo": {
    "defaultLanguageTag": "en-us",
    "additionalLanguages": [
      {
        "languageTag": "es-es",
        "file": "es-es.json"
      }
    ]
  },
  "webApplicationInfo": {
    "id": "00000000-0000-0000-0000-000000000000",
    "resource": "api://www.contoso.com/prodapp"
  },
  "authorization": {
    "permissions": {
      "resourceSpecific": [
        {
          "name": "Mailbox.ReadWrite.User",
          "type": "Delegated"
        }
      ]
    }
  },
  "extensions": [
    {
      "requirements": {
        "scopes": [ "mail" ],
        "capabilities": [
          {
            "name": "Mailbox", "minVersion": "1.1"
          }
        ]
      },
      "runtimes": [
        {
          "requirements": {
            "capabilities": [
              {
                "name": "MailBox", "minVersion": "1.10"
              }
            ]
          },
          "id": "eventsRuntime",
          "type": "general",
          "code": {
            "page": "https://contoso.com/events.html",
            "script": "https://contoso.com/events.js"
          },
          "lifetime": "short",
          "actions": [
            {
              "id": "onMessageSending",
              "type": "executeFunction"
            },
            {
              "id": "onNewMessageComposeCreated",
              "type": "executeFunction"
            }
          ]
        },
        {
          "requirements": {
            "capabilities": [
              {
                "name": "MailBox", "minVersion": "1.1"
              }
            ]
          },
          "id": "commandsRuntime",
          "type": "general",
          "code": {
            "page": "https://contoso.com/commands.html",
            "script": "https://contoso.com/commands.js"
          },
          "lifetime": "short",
          "actions": [
            {
              "id": "action1",
              "type": "executeFunction"
            },
            {
              "id": "action2",
              "type": "executeFunction"
            },
            {
              "id": "action3",
              "type": "executeFunction"
            }
          ]
        }
      ],
      "ribbons": [
        {
          "contexts": [
            "mailCompose"
          ],
          "tabs": [
            {
              "builtInTabId": "TabDefault",
              "groups": [
                {
                  "id": "dashboard",
                  "label": "Controls",
                  "controls": [
                    {
                      "id": "control1",
                      "type": "button",
                      "label": "Action 1",
                      "icons": [
                        {
                          "size": 16,
                          "url": "test_16.png"
                        },
                        {
                          "size": 32,
                          "url": "test_32.png"
                        },
                        {
                          "size": 80,
                          "url": "test_80.png"
                        }
                      ],
                      "supertip": {
                        "title": "Action 1 Title",
                        "description": "Action 1 Description"
                      },
                      "actionId": "action1"
                    },
                    {
                      "id": "menu1",
                      "type": "menu",
                      "label": "My Menu",
                      "icons": [
                        {
                          "size": 16,
                          "url": "test_16.png"
                        },
                        {
                          "size": 32,
                          "url": "test_32.png"
                        },
                        {
                          "size": 80,
                          "url": "test_80.png"
                        }
                      ],
                      "supertip": {
                        "title": "My Menu",
                        "description": "Menu with 2 actions"
                      },
                      "items": [
                        {
                          "id": "menuItem1",
                          "type": "menuItem",
                          "label": "Action 2",
                          "supertip": {
                            "title": "Action 2 Title",
                            "description": "Action 2 Description"
                          },
                          "actionId": "action2"
                        },
                        {
                          "id": "menuItem2",
                          "type": "menuItem",
                          "label": "Action 3",
                          "icons": [
                            {
                              "size": 16,
                              "url": "test_16.png"
                            },
                            {
                              "size": 32,
                              "url": "test_32.png"
                            },
                            {
                              "size": 80,
                              "url": "test_80.png"
                            }
                          ],
                          "supertip": {
                            "title": "Action 3 Title",
                            "description": "Action 3 Description"
                          },
                          "actionId": "action3"
                        }
                      ]
                    }
                  ]
                }
              ]
            }
          ]
        },
        {
          "contexts": [ "mailRead" ],
          "tabs": [
            {
              "builtInTabId": "TabDefault",
              "groups": [
                {
                  "id": "dashboard",
                  "label": "Controls",
                  "controls": [
                    {
                      "id": "control1",
                      "type": "button",
                      "label": "Action 1",
                      "icons": [
                        {
                          "size": 16,
                          "url": "test_16.png"
                        },
                        {
                          "size": 32,
                          "url": "test_32.png"
                        },
                        {
                          "size": 80,
                          "url": "test_80.png"
                        }
                      ],
                      "supertip": {
                        "title": "Action 1 Title",
                        "description": "Action 1 Description"
                      },
                      "actionId": "action1"
                    }
                  ]
                }
              ]
            }
          ]
        }
      ],
      "autoRunEvents": [
        {
          "requirements": {
            "capabilities": [
              {
                "name": "MailBox", "minVersion": "1.10"
              }
            ]
          },
          "events": [
            {
              "type": "newMessageComposeCreated",
              "actionId": "onNewMessageComposeCreated"
            },
            {
              "type": "messageSending",
              "actionId": "onMessageSending",
              "options": {
                "sendMode": "promptUser"
              }
            }
          ]
        }
      ],
      "alternates": [
        {
          "requirements": {
            "scopes": [ "mail" ]
          },
          "prefer": {
            "comAddin": {
              "progId": "ContosoExtension"
            }
          },
          "hide": {
            "storeOfficeAddin": {
              "officeAddinId": "00000000-0000-0000-0000-000000000000",
              "assetId": "WA000000000"
            }
          }
        }
      ]
    }
  ]
}

Microsoft 365 用の統合アプリマニフェストを含む Office アドイン (プレビュー)

統合マニフェストの主要なプロパティ

基本プロパティ

"extensions" プロパティ

セーフドメインを指定する

プレビュー統合マニフェストのサンプル

関連項目

フィードバック

その他のリソース

Microsoft 365 用の統合アプリ マニフェストを含む Office アドイン (プレビュー)

統合マニフェストの主要なプロパティ

基本プロパティ

"extensions" プロパティ

セーフ ドメインを指定する

プレビュー統合マニフェストのサンプル

関連項目

フィードバック

その他のリソース

Microsoft 365 用の統合アプリマニフェストを含む Office アドイン (プレビュー)

セーフドメインを指定する