会議 ID と開催者 ID を取得する

2023-08-11

アプリは、会議 ID と会議開催者のユーザー ID (開催者 ID とも呼ばれます) を使用して、会議のトランスクリプトと記録を取得できます。 Graph REST API は、API でパラメーターとして渡される会議 ID と開催者 ID に基づいて、トランスクリプトと記録をフェッチします。

注:

スケジュールされた会議の会議 ID は、未使用の場合、数日で期限切れになることがあります。会議 URL を使用して会議に参加することで復活できます。会議の種類ごとに会議の有効期限タイムラインの詳細については、「会議の有効期限」を参照してください。

トランスクリプトと記録を取得するための会議 ID と開催者 ID を取得するには、次の 2 つの方法のいずれかを選択します。

変更通知を受信する
ボットフレームワークを使用する

アプリをサブスクライブして、スケジュールされた会議イベントの変更通知を受け取ることができます。アプリがサブスクライブされた会議イベントについて通知されると、必要なMicrosoft Entraアクセス許可を介して承認されている場合、トランスクリプトと録音を取得できます。

アプリは、サブスクライブしている会議イベントの種類に関する通知を受け取ります。

ユーザーレベルの通知
テナントレベルの通知

サブスクライブされた会議イベントがアプリに通知されると、アプリは通知メッセージから会議 ID と開催者 ID を取得できます。取得した会議の詳細に基づいて、アプリは会議の終了後に会議のトランスクリプトと録音を取得できます。

ユーザーレベルの通知を使用して会議の詳細を取得する

特定のユーザーの会議イベントのトランスクリプトと記録を取得するためのユーザーレベルの通知にアプリをサブスクライブすることを選択します。そのユーザーの会議がスケジュールされると、アプリに通知されます。アプリは、カレンダーイベントを使用して会議通知を受け取ることもできます。

アプリを予定表イベントにサブスクライブする方法については、「 Microsoft Graph の Outlook リソースの変更通知」を参照してください。

次の例を使用して、ユーザーレベルの通知をサブスクライブします。

    
POST https://graph.microsoft.com/v1.0/subscriptions/
{
    "changeType": "created,updated,deleted",
    "notificationUrl": "https://webhook.azurewebsites.net/api/send/myNotifyClient",
    "resource": "users('1273a016-201d-4f95-8083-1b7f99b3edeb')/events",
    "expirationDateTime": "2022-05-05T14:58:56.7951795+00:00",
    "clientState": "ClientSecret",
    "includeResourceData": false
}

アプリは、サブスクライブされた会議イベントについて通知されると、通知でカレンダーイベント ID を探します。イベント ID を使用して、特定のチャット ID を取得し、そのメッセージをサブスクライブするための JoinWebUrl を取得します。アプリがチャットメッセージをサブスクライブしたら、テナントレベルの通知の手順に従って、会議 ID と開催者 ID を取得します。

ユーザーレベルの通知から会議 ID と開催者 ID を取得するには:

イベント ID を取得する: アプリは、通知ペイロードから eventId プロパティを取得します。

例: 通知ペイロード

{
    "subscriptionId": "ef30cdc6-b5ae-4702-b924-f458fd9e5fc3",
    "changeType": "created",
    "tenantId": "2432b57b-0abd-43db-aa7b-16eadd115d34",
    "clientState": "ClientSecret",
    "subscriptionExpirationDateTime": "2022-05-05T07:54:53.1886542-07:00",
    "resource": "Users/1273a016-201d-4f95-8083-1b7f99b3edeb/Events/AAMkADY0NjM1MjRhLTNiNjAtNDBiOC1hYTQxLThkMjAxN2QzMjZhYQBGAAAAAAC03Gz8aL_JQp2Kxvw5a29SBwDFFWHjtoMRTqdrVyQ1h8yLAAAAAAENAADFFWHjtoMRTqdrVyQ1h8yLAAFwC7nAAAA=",
    "resourceData": {}
}

この例では、resource に含まれる eventID は AAMkADY0NjM1MjRhLTNiNjAtNDBiOC1hYTQxLThkMjAxN2QzMjZhYQBGAAAAAAC03Gz8aL_JQp2Kxvw5a29SBwDFFWHjtoMRTqdrVyQ1h8yLAAAAAAENAADFFWHjtoMRTqdrVyQ1h8yLAAFwC7nAAAA= です。

会議 URL を取得する: イベント ID を使用して、会議 URL を含む joinUrl を取得します。

詳細については、 get イベントに関するページを参照してください。

次の例を使用して、会議 URL を要求します。

GET https://graph.microsoft.com/v1.0/users/1273a016-201d-4f95-8083-1b7f99b3edeb/events/AAMkADY0NjM1MjRhLTNiNjAtNDBiOC1hYTQxLThkMjAxN2QzMjZhYQBGAAAAAAC03Gz8aL_JQp2Kxvw5a29SBwDFFWHjtoMRTqdrVyQ1h8yLAAAAAAENAADFFWHjtoMRTqdrVyQ1h8yLAAFwC7nAAAA=

応答ペイロードには joinURL が含まれます。

例: 会議 URL を取得するための応答ペイロード

{
    "@odata.context": "https://graph.microsoft.com/v1.0/$metadata#users('1273a016-201d-4f95-8083-1b7f99b3edeb')/events/$entity",
    "@odata.etag": "W/\"xRVh47aDEU6na1ckNYfMiwABb2Twsg==\"",
    "id": "AAMkADY0NjM1MjRhLTNiNjAtNDBiOC1hYTQxLThkMjAxN2QzMjZhYQBGAAAAAAC03Gz8aL_JQp2Kxvw5a29SBwDFFWHjtoMRTqdrVyQ1h8yLAAAAAAENAADFFWHjtoMRTqdrVyQ1h8yLAAFwC7nAAAA=",    
    "start": {
        "dateTime": "2022-05-06T15:00:00.0000000",
        "timeZone": "UTC"
    },
    "end": {
        "dateTime": "2022-05-06T15:30:00.0000000",
        "timeZone": "UTC"
    },

    "onlineMeeting": {
        "joinUrl": "https://teams.microsoft.com/l/meetup-join/19%3ameeting_MjExYzJiMTItZDY1MS00ZGZkLWE5YzQtZTBmNWI1MDg2M2Uw%40thread.v2/0?context=%7b%22Tid%22%3a%222432b57b-0abd-43db-aa7b-16eadd115d34%22%2c%22Oid%22%3a%221273a016-201d-4f95-8083-1b7f99b3edeb%22%7d",
        "conferenceId": "438824583",
        "tollNumber": "+1 213-279-1007"
    }    
}

会議 URL は joinUrl に含まれています。

チャットスレッド ID を取得する: joinUrl で取得した会議 URL を使用して、チャットスレッド ID を取得します。関連する会議をフェッチする際に、この会議 URL を joinWebUrl パラメーターの値として指定します。

次の例を使用して、スレッド ID を要求します。

GET https://graph.microsoft.com/v1.0/users('14b779ae-cb64-47e7-a512-52fd50a4154d')/onlineMeetings?$filter=JoinWebUrl%20eq%20'https://teams.microsoft.com/l/meetup-join/19%3ameeting_MTM5OTY3MGUtNmY4Mi00Yjg4LTk2MDUtY2IyZGRlNmU1ZjA2%40thread.v2/0?context=%7b%22Tid%22%3a%222432b57b-0abd-43db-aa7b-16eadd115d34%22%2c%22Oid%22%3a%2214b779ae-cb64-47e7-a512-52fd50a4154d%22%7d'

応答ペイロードには、chatInfo プロパティ内の threadID メンバーが含まれています。

例: スレッド ID を持つ応答ペイロード

{
    "@odata.context": "https://graph.microsoft.com/v1.0/$metadata#users('14b779ae-cb64-47e7-a512-52fd50a4154d')/onlineMeetings",
    "value": [
        {
            "id": "MSoxNGI3NzlhZS1jYjY0LTQ3ZTctYTUxMi01MmZkNTBhNDE1NGQqMCoqMTk6bWVldGluZ19NVE01T1RZM01HVXRObVk0TWkwMFlqZzRMVGsyTURVdFkySXlaR1JsTm1VMVpqQTJAdGhyZWFkLnYy",
            "creationDateTime": "2022-04-26T07:41:17.3736455Z",
            "startDateTime": "2022-04-26T10:30:00Z",
            "endDateTime": "2022-04-26T11:00:00Z",
            "joinUrl": "https://teams.microsoft.com/l/meetup-join/19%3ameeting_MTM5OTY3MGUtNmY4Mi00Yjg4LTk2MDUtY2IyZGRlNmU1ZjA2%40thread.v2/0?context=%7b%22Tid%22%3a%222432b57b-0abd-43db-aa7b-16eadd115d34%22%2c%22Oid%22%3a%2214b779ae-cb64-47e7-a512-52fd50a4154d%22%7d",
            "joinWebUrl": "https://teams.microsoft.com/l/meetup-join/19%3ameeting_MTM5OTY3MGUtNmY4Mi00Yjg4LTk2MDUtY2IyZGRlNmU1ZjA2%40thread.v2/0?context=%7b%22Tid%22%3a%222432b57b-0abd-43db-aa7b-16eadd115d34%22%2c%22Oid%22%3a%2214b779ae-cb64-47e7-a512-52fd50a4154d%22%7d",
            "chatInfo": {
                "threadId": "19:meeting_MTM5OTY3MGUtNmY4Mi00Yjg4LTk2MDUtY2IyZGRlNmU1ZjA2@thread.v2",
                "messageId": "0",
                "replyChainMessageId": null
            }
        }
    ]
}

チャット ID は threadId に含まれます。

チャットメッセージをサブスクライブする: チャット ID を使用してアプリをサブスクライブし、その特定の会議のチャットメッセージを受信します。詳細については、「チャットでメッセージをサブスクライブする」を参照してください。

アプリで特定のテキストを含むメッセージをサブスクライブする場合は、「特定のテキストを含むチャットでメッセージをサブスクライブする」を参照してください。
テナントレベルの通知の手順に従って、会議 ID と開催者 ID を取得します。

テナントレベルの通知を使用して会議の詳細を取得する

テナントレベルの通知は、アプリがテナント全体のすべての会議のトランスクリプトと記録にアクセスする権限を持っている場合に便利です。スケジュールされたオンライン Teams 会議で文字起こしと記録が開始または通話が終了したときにイベントの通知を受け取るためにアプリをサブスクライブします。会議が終了すると、アプリは会議のトランスクリプトと記録にアクセスして取得できます。

アプリをテナントレベルの通知にサブスクライブする方法については、「変更通知を取得する」を参照してください。

サブスクライブされた会議イベントについてアプリに通知されると、次の通知が検索されます。

文字起こし開始イベント。
会議が終了したイベント。

これらのイベントには、チャットエンティティを取得するために使用されるチャット ID が含まれ、最終的には会議 ID と開催者 ID が含まれます。

テナントレベルの通知から会議 ID と開催者 ID を取得するには:

チャット ID を取得する: アプリは通知から chatId プロパティを取得して、後続の呼び出しを行います。アプリは、次のペイロードからチャット ID を取得できます。

トランスクリプト開始イベント: callTranscriptEventMessageDetail イベントの種類

例: 文字起こし開始イベントのペイロード

{
"subscriptionId": "1217470f-564c-4fe3-b51f-ebd962cb8797",
"changeType": "created",
"tenantId": "2432b57b-0abd-43db-aa7b-16eadd115d34",
"resource": "chats('19:meeting_ZjVkMjc0ZWYtNThkMy00ZGI1LWFiYjAtYjg3ZGU0ZWI3MzZk@thread.v2')/messages('1649787549174')",
"contentDecryptedBySimulator": {
    "@odata.context": "https://graph.microsoft.com/$metadata#chats('19%3Ameeting_ZjVkMjc0ZWYtNThkMy00ZGI1LWFiYjAtYjg3ZGU0ZWI3MzZk%40thread.v2')/messages/$entity",
    "messageType": "systemEventMessage",
    "createdDateTime": "2022-04-12T18:19:09.174Z",
    "lastModifiedDateTime": "2022-04-12T18:19:09.174Z",
    "chatId": "19:meeting_ZjVkMjc0ZWYtNThkMy00ZGI1LWFiYjAtYjg3ZGU0ZWI3MzZk@thread.v2",
    "body": {
        "contentType": "html",
        "content": "<systemEventMessage/>"
    },
    "channelIdentity": null,
    "eventDetail": {
        "@odata.type": "#Microsoft.Teams.GraphSvc.callTranscriptEventMessageDetail",
        "callId": "16481de8-3262-419b-abc7-0139e6239515",
        "callTranscriptICalUid": "",
        "meetingOrganizer": {
            "application": null,
            "device": null,
            "user": {
            "userIdentityType": "aadUser",
                "id": "14b779ae-cb64-47e7-a512-52fd50a4154d",
                "displayName": null
                }
            }
        }
    },
    "encryptedContent": {}
}

終了イベントの呼び出し: callEndedEventMessageDetail イベントの種類

例: 呼び出し終了イベントのペイロード

{
    "subscriptionId": "1217470f-564c-4fe3-b51f-ebd962cb8797",
    "changeType": "created",
    "tenantId": "2432b57b-0abd-43db-aa7b-16eadd115d34",
    "resource": "chats('19:meeting_ZjVkMjc0ZWYtNThkMy00ZGI1LWFiYjAtYjg3ZGU0ZWI3MzZk@thread.v2')/messages('1649787585457')",
    "resourceData": {},
    "contentDecryptedBySimulator": {
        "@odata.context": "https://graph.microsoft.com/$metadata#chats('19%3Ameeting_ZjVkMjc0ZWYtNThkMy00ZGI1LWFiYjAtYjg3ZGU0ZWI3MzZk%40thread.v2')/messages/$entity",
        "createdDateTime": "2022-04-12T18:19:45.457Z",
        "lastModifiedDateTime": "2022-04-12T18:19:45.457Z",     
        "chatId": "19:meeting_ZjVkMjc0ZWYtNThkMy00ZGI1LWFiYjAtYjg3ZGU0ZWI3MzZk@thread.v2",
        "eventDetail": {
            "@odata.type": "#Microsoft.Teams.GraphSvc.callEndedEventMessageDetail",
            "callId": null,
            "callDuration": "PT1M44S",
            "callEventType": "meeting",
            "callParticipants": [
            ],
            "initiator": {

            }
        }
    },
    "encryptedContent": {

    }
}

チャットエンティティを取得する: アプリは、手順 1 で取得したチャット ID を使用してチャットエンティティを取得できます。チャットエンティティを使用して、通話に参加するための URL を取得します。 onlineMeetingInfo プロパティの joinWebUrl メンバーにはこの URL が含まれており、最終的に会議 ID を取得するために使用されます。開催者 ID も応答ペイロードの一部です。

チャットエンティティの詳細については、「チャットの取得」を参照してください。

次の例を使用して、チャット ID に基づいてチャットエンティティを要求します。

GET https://graph.microsoft.com/v1.0/chats/19:meeting_NmU0NTkxYzMtM2Y2My00NzRlLWFmN2YtNTFiMGM5OWM3ZjY2@thread.v2

応答ペイロードには、次の要素が含まれています。

開催者 ID: これは、応答ペイロードの organizer プロパティの id メンバーに含まれています。

会議呼び出しの URL: この URL は会議 ID を取得するために使用され、次の 2 つのシナリオのいずれかで応答ペイロードで使用できます。

会議がオンライン Teams 会議の場合、onlineMeetingInfo プロパティの joinWebUrl メンバーにはこの URL が含まれます。
会議が Teams クライアントまたは Outlook クライアントからオンライン会議として作成されたものではない場合、onlineMeetingInfo プロパティに calendarEventId メンバーが含まれます。アプリは calendarEventId を使用して joinUrl を取得できます。これは joinWebUrl と同じです。

イベントの詳細については、「 get event」を参照してください。

参加会議 URL の種類に応じた応答ペイロードシナリオの例:

joinWebUrl が利用できるオンライン Teams 会議

例

: オンライン会議の応答ペイロード

{
    "@odata.context": "https://graph.microsoft.com/beta/$metadata#chats/$entity",
    "id": "19:meeting_NmU0NTkxYzMtM2Y2My00NzRlLWFmN2YtNTFiMGM5OWM3ZjY2@thread.v2",
    "topic": "Test Meet Create Online Meeting",
    "createdDateTime": "2022-04-14T11:30:45.903Z",
    "lastUpdatedDateTime": "2022-04-26T06:27:45.265Z",
    "chatType": "meeting",
    "webUrl": "https://teams.microsoft.com/l/chat/19%3Ameeting_NmU0NTkxYzMtM2Y2My00NzRlLWFmN2YtNTFiMGM5OWM3ZjY2%40thread.v2/0?tenantId=2432b57b-0abd-43db-aa7b-16eadd115d34",
    "tenantId": "2432b57b-0abd-43db-aa7b-16eadd115d34",
    "viewpoint": null,
    "onlineMeetingInfo": {
    "calendarEventId": null,
        "joinWebUrl": "https://teams.microsoft.com/l/meetup-join/19%3ameeting_NmU0NTkxYzMtM2Y2My00NzRlLWFmN2YtNTFiMGM5OWM3ZjY2%40thread.v2/0?context=%7b%22Tid%22%3a%222432b57b-0abd-43db-aa7b-16eadd115d34%22%2c%22Oid%22%3a%2214b779ae-cb64-47e7-a512-52fd50a4154d%22%7d",
        "organizer": {
            "id": "14b779ae-cb64-47e7-a512-52fd50a4154d",
            "displayName": null,
            "userIdentityType": "aadUser"
        }
    }
}

Teams クライアントまたは Outlook クライアントを通じてスケジュールされた会議で、calendarEventId が利用可能なオンライン会議としてマークされていない

例: 会議の応答ペイロードがオンラインとしてマークされていない

{
    "@odata.context": "https://graph.microsoft.com/beta/$metadata#chats/$entity",
    "id": "19:meeting_YzM1NGFiZWYtOGFiOS00NjM5LTg4OTktYmU0MjI4NTQyNGZm@thread.v2",
    "topic": "Non Online Meeting Teams Client",
    "createdDateTime": "2022-04-26T09:43:23.711Z",
    "lastUpdatedDateTime": "2022-04-26T09:43:46.157Z",
    "chatType": "meeting",
    "webUrl": "https://teams.microsoft.com/l/chat/19%3Ameeting_YzM1NGFiZWYtOGFiOS00NjM5LTg4OTktYmU0MjI4NTQyNGZm%40thread.v2/0?tenantId=2432b57b-0abd-43db-aa7b-16eadd115d34",
    "tenantId": "2432b57b-0abd-43db-aa7b-16eadd115d34",
    "viewpoint": null,
    "onlineMeetingInfo": {
        "calendarEventId": "AAMkAGE3NjJhOTVhLTNkZDQtNDE2OS05ZjU0LTJmOGQ0YTY2YTdiZQBGAAAAAAD3AG5jNnlgQJvdCL_KgXJIBwBsww5BlIxtT7iFyYWrXV3AAAAAAAENAABsww5BlIxtT7iFyYWrXV3AAACSDwYeAAA=",
        "joinWebUrl": null,
        "organizer": {
            "id": "14b779ae-cb64-47e7-a512-52fd50a4154d",
            "displayName": null,
            "userIdentityType": "aadUser"
        }
    }
}

次の例を使用して、calendarEventId から joinWebUrl を取得します。

  GET https://graph.microsoft.com/beta/users/14b779ae-cb64-47e7-a512-52fd50a4154d/events/AAMkAGE3NjJhOTVhLTNkZDQtNDE2OS05ZjU0LTJmOGQ0YTY2YTdiZQBGAAAAAAD3AG5jNnlgQJvdCL_KgXJIBwBsww5BlIxtT7iFyYWrXV3AAAAAAAENAABsww5BlIxtT7iFyYWrXV3AAACSDwYdAAA=

この例では次のようになっています。

開催者 ID は 14b779ae-cb64-47e7-a512-52fd50a4154d です。

この要求の応答ペイロードには、onlineMeeting プロパティに joinUrl が含まれています。

注:

joinUrl は joinWebUrl と同じです。

例: 会議に参加する URL を含む応答ペイロード

{
  "@odata.context": "https://graph.microsoft.com/beta/$metadata#users('14b779ae-cb64-47e7-a512-52fd50a4154d')/events/$entity",
  "@odata.etag": "W/\"bMMOQZSMbU+4hcmFq11dwAAAkc3Tmw==\"",
  "id": "AAMkAGE3NjJhOTVhLTNkZDQtNDE2OS05ZjU0LTJmOGQ0YTY2YTdiZQBGAAAAAAD3AG5jNnlgQJvdCL_KgXJIBwBsww5BlIxtT7iFyYWrXV3AAAAAAAENAABsww5BlIxtT7iFyYWrXV3AAACSDwYdAAA=",    
  "start": {
      "dateTime": "2022-04-26T10:30:00.0000000",
      "timeZone": "UTC"
  },
  "end": {
      "dateTime": "2022-04-26T11:00:00.0000000",
      "timeZone": "UTC"
  },    
  "onlineMeeting": {
      "joinUrl": "https://teams.microsoft.com/l/meetup-join/19%3ameeting_MTM5OTY3MGUtNmY4Mi00Yjg4LTk2MDUtY2IyZGRlNmU1ZjA2%40thread.v2/0?context=%7b%22Tid%22%3a%222432b57b-0abd-43db-aa7b-16eadd115d34%22%2c%22Oid%22%3a%2214b779ae-cb64-47e7-a512-52fd50a4154d%22%7d"
  },
  "calendar@odata.associationLink": "https://graph.microsoft.com/beta/users('14b779ae-cb64-47e7-a512-52fd50a4154d')/calendars('AAMkAGE3NjJhOTVhLTNkZDQtNDE2OS05ZjU0LTJmOGQ0YTY2YTdiZQAuAAAAAAD3AG5jNnlgQJvdCL_KgXJIAQBsww5BlIxtT7iFyYWrXV3AAAAAAAENAAA=')/$ref",
  "calendar@odata.navigationLink": "https://graph.microsoft.com/beta/users('14b779ae-cb64-47e7-a512-52fd50a4154d')/calendars('AAMkAGE3NjJhOTVhLTNkZDQtNDE2OS05ZjU0LTJmOGQ0YTY2YTdiZQAuAAAAAAD3AG5jNnlgQJvdCL_KgXJIAQBsww5BlIxtT7iFyYWrXV3AAAAAAAENAAA=')"
  }

会議 ID を取得する: これで、アプリは joinWebUrl を使用して会議 ID を取得できます。

次の例を使用して、オンライン会議 ID を要求します。

GET https://graph.microsoft.com/beta/users('14b779ae-cb64-47e7-a512-52fd50a4154d')/onlineMeetings?$filter=JoinWebUrl%20eq%20'https://teams.microsoft.com/l/meetup-join/19%3ameeting_MTM5OTY3MGUtNmY4Mi00Yjg4LTk2MDUtY2IyZGRlNmU1ZjA2%40thread.v2/0?context=%7b%22Tid%22%3a%222432b57b-0abd-43db-aa7b-16eadd115d34%22%2c%22Oid%22%3a%2214b779ae-cb64-47e7-a512-52fd50a4154d%22%7d'

応答ペイロードには、value プロパティの id メンバーに会議 ID が含まれています。

例: 会議 ID を持つ応答ペイロード

{
    "@odata.context": "https://graph.microsoft.com/beta/$metadata#users('14b779ae-cb64-47e7-a512-52fd50a4154d')/onlineMeetings",
    "value": [
        {
            "id": "MSoxNGI3NzlhZS1jYjY0LTQ3ZTctYTUxMi01MmZkNTBhNDE1NGQqMCoqMTk6bWVldGluZ19NVE01T1RZM01HVXRObVk0TWkwMFlqZzRMVGsyTURVdFkySXlaR1JsTm1VMVpqQTJAdGhyZWFkLnYy",
            "creationDateTime": "2022-04-26T07:41:17.3736455Z",
            "startDateTime": "2022-04-26T10:30:00Z",
            "endDateTime": "2022-04-26T11:00:00Z",
            "joinUrl": "https://teams.microsoft.com/l/meetup-join/19%3ameeting_MTM5OTY3MGUtNmY4Mi00Yjg4LTk2MDUtY2IyZGRlNmU1ZjA2%40thread.v2/0?context=%7b%22Tid%22%3a%222432b57b-0abd-43db-aa7b-16eadd115d34%22%2c%22Oid%22%3a%2214b779ae-cb64-47e7-a512-52fd50a4154d%22%7d",
            "joinWebUrl": "https://teams.microsoft.com/l/meetup-join/19%3ameeting_MTM5OTY3MGUtNmY4Mi00Yjg4LTk2MDUtY2IyZGRlNmU1ZjA2%40thread.v2/0?context=%7b%22Tid%22%3a%222432b57b-0abd-43db-aa7b-16eadd115d34%22%2c%22Oid%22%3a%2214b779ae-cb64-47e7-a512-52fd50a4154d%22%7d",
            "chatInfo": {
                "threadId": "19:meeting_MTM5OTY3MGUtNmY4Mi00Yjg4LTk2MDUtY2IyZGRlNmU1ZjA2@thread.v2",
                "messageId": "0",
                "replyChainMessageId": null
            }
        }
    ]
}

トランスクリプトまたはレコーディングをフェッチする: 手順 2 および 3 で取得した開催者 ID と会議 ID を使用すると、アプリはその特定の会議イベントのトランスクリプトまたは記録をフェッチできます。
- トランスクリプトをフェッチするには、次のことを行う必要があります。
  1. 開催者 ID と会議 ID に基づいてトランスクリプト ID を取得します。
    
    次の例を使用して、トランスクリプト ID を要求します。
```
GET https://graph.microsoft.com/beta/users('14b779ae-cb64-47e7-a512-52fd50a4154d')/onlineMeetings('MSoxNGI3NzlhZS1jYjY0LTQ3ZTctYTUxMi01MmZkNTBhNDE1NGQqMCoqMTk6bWVldGluZ19ObVUwTlRreFl6TXRNMlkyTXkwME56UmxMV0ZtTjJZdE5URmlNR001T1dNM1pqWTJAdGhyZWFkLnYy')/transcripts
```
    この例では次のようになっています。
    - 会議 ID は、onlineMeetings の値として含まれています: MSoxNGI3NzlhZS1jYjY0LTQ3ZTctYTUxMi01MmZkNTBhNDE1NGQqMCoqMTk6bW VldGluZ19ObVUwTlRreFl6TXRNMlkyTXkwME56UmxMV0ZtTjJZdE5URmlNR001T1dNM 1pqWTJAdGhyZWFkLnYy。
    - 開催者 ID は 14b779ae-cb64-47e7-a512-52fd50a4154d です。
    応答ペイロードには、value プロパティの id メンバーの会議 ID と開催者 ID のトランスクリプト ID が含まれています。
    例: トランスクリプト ID を取得するための応答ペイロード
```
{
"@odata.context": "https://graph.microsoft.com/beta/$metadata#users('14b779ae-cb64-47e7-a512-52fd50a4154d')/onlineMeetings('MSoxNGI3NzlhZS1jYjY0LTQ3ZTctYTUxMi01MmZkNTBhNDE1NGQqMCoqMTk6bWVldGluZ19ObVUwTlRreFl6TXRNMlkyTXkwME56UmxMV0ZtTjJZdE5URmlNR001T1dNM1pqWTJAdGhyZWFkLnYy')/transcripts",
"@odata.count": 1,
"value": [
    {
        "id": "MSMjMCMjMDEyNjJmNjgtOTc2Zi00MzIxLTlhNDQtYThmMmY4ZjQ1ZjVh",
        "createdDateTime": "2022-04-14T11:34:39.5662792Z"
    }
]
}
```
    この例では、トランスクリプト ID は MSMjMCMjMDEyNjJmNjgtOTc2Zi00MzIxLTlhNDQtYThmMmY4ZjQ1ZjVh です。
  2. トランスクリプト ID に基づいて、会議のトランスクリプトにアクセスして取得します。
    
    次の例を使用して、特定の会議のトランスクリプトを .vtt 形式で要求します。
```
 GET https://graph.microsoft.com/beta/users('14b779ae-cb64-47e7-a512-52fd50a4154d')/onlineMeetings('MSoxNGI3NzlhZS1jYjY0LTQ3ZTctYTUxMi01MmZkNTBhNDE1NGQqMCoqMTk6bWVldGluZ19ObVUwTlRreFl6TXRNMlkyTXkwME56UmxMV0ZtTjJZdE5URmlNR001T1dNM1pqWTJAdGhyZWFkLnYy')/transcripts('MSMjMCMjMDEyNjJmNjgtOTc2Zi00MzIxLTlhNDQtYThmMmY4ZjQ1ZjVh')/content?$format=text/vtt
```
    応答ペイロードには、 .vtt 形式のトランスクリプトが含まれています。
- 録音をフェッチするには、次の手順を実行する必要があります。
  1. 開催者 ID と会議 ID に基づいて記録 ID を取得します。
    
    記録 ID を要求するには、次の例を使用します。
```
GET  https://graph.microsoft.com/beta/users/b935e675-5e67-48b9-8d45-249d5f88e964/onlineMeetings/MSpiOTM1ZTY3NS01ZTY3LTQ4YjktOGQ0NS0yNDlkNWY4OGU5NjQqMCoqMTk6bWVldGluZ19ZbU0zTnpJNU9USXRZakU0WlMwME1tUTNMVGt6TVRRdFkyWm1PRGRtWmpsaVptRTNAdGhyZWFkLnYy/recordings/
```
    この例では次のようになっています。
    - 会議 ID は、 onlineMeetingsの値として含まれます: MSpiOTM1ZTY3NS01ZTY3LTQ4YjktOGQ0NS0yNDlkNWY4OGU5NjQqMCoqMTk6bWVl dGluZ19ZbU0zTnpJNU9USXRZakU0WlMwME1tUTNMVGt6TVRRdFkyWm1 PRGRtWmpsaVptRTNAdGhyZWFkLnYy.
    - 開催者 ID は b935e675-5e67-48b9-8d45-249d5f88e964 です。
    応答ペイロードには、value プロパティのid メンバーの会議 ID と開催者 ID の記録 ID が含まれています。
    例: 記録 ID を取得するための応答ペイロード
```
{
"@odata.context": "https://graph.microsoft.com/beta/$metadata#users('b935e675-5e67-48b9-8d45-249d5f88e964')/onlineMeetings('MSpiOTM1ZTY3NS01ZTY3LTQ4YjktOGQ0NS0yNDlkNWY4OGU5NjQqMCoqMTk6bWVldGluZ19ZbU0zTnpJNU9USXRZakU0WlMwME1tUTNMVGt6TVRRdFkyWm1PRGRtWmpsaVptRTNAdGhyZWFkLnYy')/recordings",
"@odata.count": 1,
"value": [
    {
"id": "7e31db25-bc6e-4fd8-96c7-e01264e9b6fc",
"createdDateTime": "2023-04-10T08:13:17.5990966Z"
    }
]
}
```
    この例では、記録 ID は 7e31db25-bc6e-4fd8-96c7-e01264e9b6fc です。
  2. 記録 ID に基づいて会議の記録にアクセスして取得します。
    
    次の例を使用して、特定の会議の記録を .mp4 形式で要求します。
```
GET https://graph.microsoft.com/beta/users/b935e675-5e67-48b9-8d45-249d5f88e964/onlineMeetings/MSpiOTM1ZTY3NS01ZTY3LTQ4YjktOGQ0NS0yNDlkNWY4OGU5NjQqMCoqMTk6bWVldGluZ19ZbU0zTnpJNU9USXRZakU0WlMwME1tUTNMVGt6TVRRdFkyWm1PRGRtWmpsaVptRTNAdGhyZWFkLnYy/recordings/7e31db25-bc6e-4fd8-96c7-e01264e9b6fc/content?$format=video/mp4
```
    応答ペイロードには、 .mp4 形式の記録が含まれています。

ボットフレームワークを使用して会議 ID と開催者 ID を取得する

アプリでは、会議 ID と開催者 ID を取得するためにボットフレームワークを使用できます。ボットは、スケジュールされたすべてのオンライン会議から会議の開始または終了イベントを自動的に受信できます。

次の例を使用して、ボットアプリを使用して会議 ID と開催者 ID を取得します。

GET /v1/meetings/{meetingId}

応答ペイロードには次のものが含まれます。

details プロパティの msGraphResourceId メンバーの会議 ID。
organizer プロパティの id メンバーの開催者 ID。

例

: 会議の詳細を取得するための応答ペイロード

{
  details: {
    id: "MCMxOTptZWV0aW5nX05XTTFNVEk1TnpNdE5qZ3pNeTAwWVdRNExUaG1PV1F0WlRnM01UQm1PVGczWW1VekB0aHJlYWQudjIjMA==",
    msGraphResourceId: "MSo2NzAyYWZiNi0xMDliLTRjMzItYTE0MS02ZTY1NDY5NTAyYjkqMCoqMTk6bWVldGluZ19OV00xTVRJNU56TXROamd6TXkwMFlXUTRMVGhtT1dRdFpUZzNNVEJtT1RnM1ltVXpAdGhyZWFkLnYy",
    scheduledStartTime: {
    },
    scheduledEndTime: {
    },
    joinUrl: "https://teams.microsoft.com/l/meetup-join/19%3ameeting_NWM1MTI5NzMtNjgzMy00YWQ4LThmOWQtZTg3MTBmOTg3YmUz%40thread.v2/0?context=%7b%22Tid%22%3a%22b3cdf1c8-024a-49e2-a994-f67f830b02f3%22%2c%22Oid%22%3a%226702afb6-109b-4c32-a141-6e65469502b9%22%7d",
    title: "Testing meeting bot 1 - Hun",
    type: "Scheduled",
  },
  conversation: {
    id: "19:meeting_NWM1MTI5NzMtNjgzMy00YWQ4LThmOWQtZTg3MTBmOTg3YmUz@thread.v2",
    isGroup: true,
    conversationType: "groupChat",
  },
  organizer: {
    id: "29:1VZkVr77S3GW_RdAXKrfgFeytpqMegL3tkKvEbwrPqoCVvmqrlKtVrfKWUY7xIM-bZIx4Sq-p1MjdjSZnb5W20w",
    tenantId: "b3cdf1c8-024a-49e2-a994-f67f830b02f3",
    aadObjectId: "6702afb6-109b-4c32-a141-6e65469502b9",
  },
}

この例では次のようになっています。

会議 ID は msGraphResourceId の値として含まれています: MSo2NzAyYWZiNi0xMDliLTRjMzItYTE0MS02ZTY1NDY5NTAyYjkqMCoqMTk6bWVl dGluZ19OV00xTVRJNU56TXROamd6TXkwMFlXUTRMVGhtT1dRdFpUZzNNVEJtT1RnM 1ltVXpAdGhyZWFkLnYy。
開催者 ID は、organizerのaadObjectIdの値として含まれます。6702afb6-109b-4c32-a141-6e65469502b9。

アプリが会議 ID と開催者 ID を取得すると、Graph API がトリガーされ、これらの会議の詳細を使用してトランスクリプトコンテンツと記録がフェッチされます。

コードサンプル

ボットアプリの次のコードサンプルを試すことができます。

サンプルの名前	説明	.NET	Node.js
会議のトランスクリプト	このサンプルアプリは、Graph APIを介して会議のトランスクリプトを取得し、タスクモジュールに表示します。	表示	表示
会議のトランスクリプトと記録	Microsoft Teams用のこのサンプルアプリケーションを使用すると、ユーザーは会議のトランスクリプトと記録をキャプチャでき、ディスカッションや意思決定を効率的に文書化できます。 Node.js を使用した簡単なセットアップと統合により、チームのコラボレーションが強化され、重要な会議の詳細が失われないようにします。	表示	表示
[Tab Meeting Recording and transcript with auto recording]$自動記録を使用した会議の記録とトランスクリプト$	このサンプルでは、会議の自動記録とトランスクリプトを有効にし、コラボレーションと記録保持を強化するMicrosoft Teams アプリを紹介します。ユーザーフレンドリーなインターフェイスとシームレスな統合により、チームは重要な詳細を見逃すことなくディスカッションに集中できます。	表示	-

次の手順

トランスクリプトをフェッチするための Graph API

記録をフェッチするための Graph API

次の方法で共有

コードサンプル

次の手順

関連項目

次の方法で共有

会議 ID と開催者 ID を取得する

変更通知を受信する

ユーザー レベルの通知を使用して会議の詳細を取得する

テナント レベルの通知を使用して会議の詳細を取得する

ボット フレームワークを使用して会議 ID と開催者 ID を取得する

コード サンプル

次の手順

関連項目

フィードバック

その他のリソース

ユーザーレベルの通知を使用して会議の詳細を取得する

テナントレベルの通知を使用して会議の詳細を取得する

ボットフレームワークを使用して会議 ID と開催者 ID を取得する

コードサンプル