次の方法で共有

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

  • [アーティクル]

アプリは、会議 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 を取得するには:

  1. イベント 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= です。

  2. 会議 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 に含まれています。

  3. チャット スレッド 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 に含まれます。

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

    アプリで特定のテキストを含むメッセージをサブスクライブする場合は、「特定のテキスト を含むチャットでメッセージをサブスクライブする」を参照してください。

  5. テナント レベルの通知の手順に従って、会議 ID と開催者 ID を取得します。

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

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

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

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

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

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

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

  1. チャット 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": {

    }
}

  2. チャット エンティティを取得する: アプリは、手順 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=')"
  }

  3. 会議 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
            }
        }
    ]
}

  4. トランスクリプトまたはレコーディングをフェッチする: 手順 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 を使用して会議のトランスクリプトを取得し、ダイアログに表示する方法を示すサンプル アプリケーションです (TeamsJS v1.x のタスク モジュールと呼ばれます)。 表示 表示
会議のトランスクリプトと記録 これは、Graph API を使用して会議のトランスクリプトと記録を取得する方法を示すサンプル アプリケーションです。 表示 表示
[Tab Meeting Recording and transcript with auto recording]\(自動記録を使用した会議の記録とトランスクリプト\) このコード サンプルでは、自動記録と自動文字起こしのために会議アプリをビルドして構成する方法を示します。 表示 -

次の手順

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

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

関連項目