個人用アプリまたはタブからコンテンツを共有する - Teams

[アーティクル]
12/20/2024

Teams に共有すると、ユーザーは個人用アプリまたはタブのコンテンツを Teams 内の他のユーザーまたはグループまたはチャネルと共有できます。ユーザーは [Teams に共有] を選択して、ポップアップウィンドウで [Teams に共有] エクスペリエンスを起動できます。ポップアップウィンドウを使用すると、ユーザーは他のユーザーまたはグループまたはチャネルを追加してコンテンツを共有できます。

次の図は、[Teams に共有] ポップアップウィンドウを示しています。

デスクトップ
モバイル

注:

個人用アプリまたはタブで Teams への共有を有効にするには、 JavaScript クライアントライブラリ (@microsoft/teams-js@1.11.0-beta.7 以降) がMicrosoft Teamsされていることを確認します。

Teams への共有を有効にするには:

Teams Javascript クライアントライブラリを使用して個人用アプリまたはタブを作成します。
[Teams に共有] ボタンを作成します。
[Teams に共有] ボタンで、コンテンツペイロードを使用して microsoftTeams.sharing.shareWebContent を呼び出します。

次の例では、コンテンツペイロードを作成する方法について説明します。

microsoftTeams.sharing.shareWebContent({
        content: [
          {
            type: 'URL',
            url: '<URL to be shared>',
            message: 'Default message to be loaded in the compose box',
            preview: true
          }
        ]
      });

ペイロードには、次のパラメーターが含まれています。

プロパティ名	用途
`type`	型はである必要があります。 `URL`
`url`	`URL` 共有する
`message`	新規作成ボックスに読み込まれる既定のメッセージ
`preview`	URL プレビューを有効にするには、 `true` に設定します

次の図は、[Teams に共有] オプションを示しています。

[Teams に共有] ボタンは、Teams 内で実行されているアプリでホストまたは埋め込むことができます。 Teams JavaScript クライアントライブラリを使用して作成されたアプリに [Teams に共有] ボタンを追加できます。

注:

Teams への共有は、モーダルダイアログ (TeamsJS v1.x のタスクモジュールと呼ばれます) または Teams Web クライアントの Stageview 内ではサポートされていません。別のモーダルの上にモーダルを開くすることはできません。

応答コード

次の表に、応答コードを示します。

応答コード	説明
100	現在のプラットフォームでは API はサポートされていません。
404	指定されたファイルが指定された場所に見つかりませんでした。
500	必要な操作の実行中に内部エラーが発生しました。
501	API は現在のコンテキストではサポートされていません。
1000	ユーザーによって拒否されたアクセス許可。
2000	ネットワークの問題。
3000	基になるハードウェアでは、この機能はサポートされていません。
4000	いくつかの引数は無効です。
5000	この操作に対してユーザーが承認されていません。
6000	リソースが不足しているため、操作を完了できませんでした。
7000	API が頻繁に呼び出されたため、プラットフォームによって要求が調整されました。
8000	ユーザーが操作を中止しました。
9000	プラットフォームコードは古く、この API は実装されていません。
10,000	戻り値が大きすぎて、サイズの境界を超えています。