Freigeben über

Abrufen von Besprechungs-ID und Organisator-ID

  • Artikel

Ihre App kann Transkripte und Aufzeichnungen einer Besprechung mithilfe der Besprechungs-ID und der Benutzer-ID des Besprechungsorganisators abrufen, die auch als Organisator-ID bezeichnet wird. Die Graph-REST-APIs rufen Transkripte und Aufzeichnungen basierend auf der Besprechungs-ID und der Organisator-ID ab, die als Parameter in der API übergeben werden.

Hinweis

Die Besprechungs-ID für geplante Besprechungen kann in einigen Tagen ablaufen, wenn sie nicht verwendet wird. Sie kann mithilfe der Besprechungs-URL wiederbelebt werden, um an der Besprechung teilzunehmen. Weitere Informationen zur Ablaufzeit von Besprechungen für verschiedene Besprechungstypen finden Sie unter Ablauf von Besprechungen.

Um die Besprechungs-ID und die Organisator-ID zum Abrufen des Transkripts und der Aufzeichnung abzurufen, wählen Sie eine der beiden Möglichkeiten aus:

Abonnieren von Änderungsbenachrichtigungen

Sie können Ihre App abonnieren, um Änderungsbenachrichtigungen für geplante Besprechungsereignisse zu erhalten. Wenn Ihre App über die abonnierten Besprechungsereignisse benachrichtigt wird, kann sie Transkripte und Aufzeichnungen abrufen, wenn sie über erforderliche Microsoft Entra-Berechtigungen autorisiert ist.

Ihre App erhält eine Benachrichtigung über den Typ der Besprechungsereignisse, für die sie abonniert ist:

Wenn Ihre App über ein abonniertes Besprechungsereignis benachrichtigt wird, kann sie die Besprechungs-ID und Organisator-ID aus der Benachrichtigungsnachricht abrufen. Basierend auf den erhaltenen Besprechungsdetails kann Ihre App die Besprechungstranskripte und -aufzeichnungen abrufen, nachdem die Besprechung beendet wurde.

Abrufen von Besprechungsdetails mithilfe von Benachrichtigungen auf Benutzerebene

Wählen Sie aus, dass Ihre App Benachrichtigungen auf Benutzerebene zum Abrufen von Transkripten und Aufzeichnungen des Besprechungsereignisses eines bestimmten Benutzers abonnieren soll. Wenn eine Besprechung für diesen Benutzer geplant ist, wird Ihre App benachrichtigt. Ihre App kann auch Besprechungsbenachrichtigungen mithilfe von Kalenderereignissen empfangen.

Informationen zum Abonnieren von Kalenderereignissen ihrer App finden Sie unter Änderungsbenachrichtigungen für Outlook-Ressourcen in Microsoft Graph.

Verwenden Sie das folgende Beispiel, um Benachrichtigungen auf Benutzerebene zu abonnieren:

    
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
}

Wenn Ihre App über ein abonniertes Besprechungsereignis benachrichtigt wird, sucht sie in der Benachrichtigung nach der Kalenderereignis-ID. Verwenden Sie die Ereignis-ID, um JoinWebUrl eine bestimmte Chat-ID abzurufen und ihre Nachrichten zu abonnieren. Nachdem Ihre App die Chatnachrichten abonniert hat, führen Sie die für Benachrichtigungen auf Mandantenebene angegebenen Schritte aus, um Besprechungs-ID und Organisator-ID abzurufen.

So erhalten Sie Besprechungs-ID und Organisator-ID aus Benachrichtigungen auf Benutzerebene:

  1. Ereignis-ID abrufen: Ihre App ruft die eventId Eigenschaft aus der Benachrichtigungsnutzlast ab.

    Beispiel: Benachrichtigungsnutzlast 
    {
    "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": {}
}

    In diesem Beispiel ist das eventID enthaltene resourceElement AAMkADY0NjM1MjRhLTNiNjAtNDBiOC1hYTQxLThkMjAxN2QzMjZhYQBGAAAAAAC03Gz8aL_JQp2Kxvw5a29SBwDFFWHjtoMRTqdrVyQ1h8yLAAAAAAENAADFFWHjtoMRTqdrVyQ1h8yLAAFwC7nAAAA=.

  2. Abrufen der Besprechungs-URL: Verwenden Sie die Ereignis-ID, um die Besprechungs-URL abzurufen joinUrl.

    Weitere Informationen finden Sie unter Get-Ereignis.

    Verwenden Sie das folgende Beispiel, um die Besprechungs-URL anzufordern:

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

    Die Antwortnutzlast enthält joinURL.

    Beispiel: Antwortnutzlast zum Abrufen der Besprechungs-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"
    }    
}

    Die Besprechungs-URL ist in joinUrl enthalten.

  3. Abrufen der Chatthread-ID: Verwenden Sie die abgerufene joinUrl Besprechungs-URL, um die Chatthread-ID abzurufen. Geben Sie diese Besprechungs-URL als Wert für den joinWebUrl Parameter an, während Sie die zugehörige Besprechung abrufen.

    Verwenden Sie das folgende Beispiel, um die Thread-ID anzufordern:

    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'

    Die Antwortnutzlast enthält das threadID Element in der chatInfo Eigenschaft.

    Beispiel: Antwortnutzlast mit Thread-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
            }
        }
    ]
}

    Die Chat-ID ist in threadId enthalten.

  4. Chatnachrichten abonnieren: Verwenden Sie die Chat-ID, um Ihre App zu abonnieren, um Chatnachrichten für diese bestimmte Besprechung zu empfangen. Weitere Informationen finden Sie unter Abonnieren von Nachrichten in einem Chat.

    Wenn Ihre App Nachrichten mit einem bestimmten Text abonnieren soll, lesen Sie Abonnieren von Nachrichten in einem Chat, die bestimmten Text enthalten.

  5. Führen Sie die Schritte für Benachrichtigungen auf Mandantenebene aus, um Besprechungs-ID und Organisator-ID abzurufen.

Abrufen von Besprechungsdetails mithilfe von Benachrichtigungen auf Mandantenebene

Benachrichtigungen auf Mandantenebene sind nützlich, wenn Ihre App für den Zugriff auf alle Besprechungstranskripte und -aufzeichnungen im gesamten Mandanten autorisiert ist. Abonnieren Sie Ihre App, um für Ereignisse benachrichtigt zu werden, wenn die Transkription und Aufzeichnung beginnt oder der Anruf für geplante Teams-Onlinebesprechungen endet. Nachdem die Besprechung beendet wurde, kann Ihre App auf das Besprechungstranskript und die Aufzeichnung zugreifen und diese abrufen.

Informationen zum Abonnieren von Benachrichtigungen auf Mandantenebene für Ihre App finden Sie unter Abrufen von Änderungsbenachrichtigungen.

Wenn Ihre App über abonnierte Besprechungsereignisse benachrichtigt wird, durchsucht sie die Benachrichtigungen nach:

  • Transkription gestartete Ereignisse.
  • Besprechungsendeereignisse.

Diese Ereignisse enthalten die Chat-ID, die zum Abrufen der Chatentität verwendet wird, und schließlich die Besprechungs-ID und die Organisator-ID.

So erhalten Sie Besprechungs-ID und Organisator-ID aus Benachrichtigungen auf Mandantenebene:

  1. Chat-ID abrufen: Ihre App ruft die chatId Eigenschaft aus der Benachrichtigung ab, um nachfolgende Anrufe zu tätigen. Ihre App kann die Chat-ID aus folgenden Nutzlasten abrufen:

    • Ereignis "Transkription gestartet": callTranscriptEventMessageDetail Ereignistyp

      Beispiel: Nutzlast für das Ereignis "Transkription gestartet" 
      {
"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": {}
}

    • Ereignis "Aufruf beendet": callEndedEventMessageDetail Ereignistyp

      Beispiel: Nutzlast für das Ereignis "Aufruf beendet" 
      {
    "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. Chatentität abrufen: Ihre App kann die Chatentität mithilfe der in Schritt 1 abgerufenen Chat-ID abrufen. Verwenden Sie die Chatentität, um die URL für die Teilnahme am Anruf abzurufen. Das joinWebUrl Mitglied der onlineMeetingInfo Eigenschaft enthält diese URL und wird verwendet, um schließlich die Besprechungs-ID abzurufen. Die Organisator-ID ist auch Teil der Antwortnutzlast.

    Weitere Informationen zur Chatentität finden Sie unter Get Chat.

    Verwenden Sie das folgende Beispiel, um die Chatentität basierend auf der Chat-ID anzufordern:

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

    Die Antwortnutzlast enthält die folgenden Elemente:

    • Organisator-ID: Sie ist im id Element der organizer Eigenschaft in der Antwortnutzlast enthalten.

    • URL für Besprechungsanrufe: Diese URL wird zum Abrufen der Besprechungs-ID verwendet und ist in der Antwortnutzlast in einem der beiden Szenarien verfügbar:

      • Wenn es sich bei der Besprechung um eine Online-Teams-Besprechung handelt, enthält das joinWebUrl Mitglied der onlineMeetingInfo Eigenschaft diese URL.
      • Wenn die Besprechung nicht als Onlinebesprechung vom Teams-Client oder Outlook-Client erstellt wurde, enthält sie das calendarEventId Mitglied in der onlineMeetingInfo Eigenschaft. Ihre App kann die calendarEventId zum Abrufen joinUrlverwenden, die identisch ist mit joinWebUrl.

      Weitere Informationen zu Ereignissen finden Sie unter Get-Ereignis.

      Beispiele für Antwortnutzlastszenarien, die vom Typ der Teilnahme an der Besprechungs-URL abhängen:

      • Online-Teams-Besprechung, wo joinWebUrl verfügbar

        Beispiel
        : Antwortnutzlast für Onlinebesprechung 
        {
    "@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"
        }
    }
}

      • Besprechung, die über den Teams-Client oder Outlook-Client geplant wurde, nicht als Onlinebesprechung gekennzeichnet, wo calendarEventId verfügbar

        Beispiel: Antwortnutzlast für Besprechungen, die nicht als online markiert sind 
        {
    "@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"
        }
    }
}

        • Verwenden Sie das folgende Beispiel, um joinWebUrl aus dem calendarEventId abzurufen:

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

          In diesem Beispiel:

          • Die Organisator-ID lautet 14b779ae-cb64-47e7-a512-52fd50a4154d.

          Die Antwortnutzlast dieser Anforderung enthält joinUrl die onlineMeeting Eigenschaft.

          Hinweis

          joinUrl ist identisch mit joinWebUrl.


          Beispiel: Antwortnutzlast, die die URL für die Teilnahme an der Besprechung enthält 
          {
  "@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. Besprechungs-ID abrufen: Jetzt kann Ihre App die Besprechungs-ID abrufen joinWebUrl.

    Verwenden Sie das folgende Beispiel, um die Onlinebesprechungs-ID anzufordern:

    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'

    Die Antwortnutzlast enthält die Besprechungs-ID im id Element der value Eigenschaft.

    Beispiel: Antwortnutzlast mit Besprechungs-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. Abrufen eines Transkripts oder einer Aufzeichnung: Mit der Organisator-ID und der Besprechungs-ID, die sie in den Schritten 2 und 3 abgerufen haben, können Die App die Transkripte oder Aufzeichnungen für dieses bestimmte Besprechungsereignis abrufen.

    • Zum Abrufen von Transkriptionen müssen Sie Folgendes ausführen:

      1. Rufen Sie die Transkript-ID basierend auf der Organisator-ID und der Besprechungs-ID ab:

        Verwenden Sie das folgende Beispiel, um die Transkript-ID anzufordern:

        GET https://graph.microsoft.com/beta/users('14b779ae-cb64-47e7-a512-52fd50a4154d')/onlineMeetings('MSoxNGI3NzlhZS1jYjY0LTQ3ZTctYTUxMi01MmZkNTBhNDE1NGQqMCoqMTk6bWVldGluZ19ObVUwTlRreFl6TXRNMlkyTXkwME56UmxMV0ZtTjJZdE5URmlNR001T1dNM1pqWTJAdGhyZWFkLnYy')/transcripts

        In diesem Beispiel:

        • Die Besprechungs-ID ist als Wert für onlineMeetings enthalten: MSoxNGI3NzlhZS1jYjY0LTQ3ZTctYTUxMi01MmZkNTBhNDE1NGQqMCoqMTk6bW VldGluZ19ObVUwTlRreFl6TXRNMlkyTXkwME56UmxMV0ZtTjJZdE5URmlNR001T1dNM 1pqWTJAdGhyZWFkLnYy.
        • Die Organisator-ID lautet 14b779ae-cb64-47e7-a512-52fd50a4154d.

        Die Antwortnutzlast enthält die Transkript-ID für die Besprechungs-ID und die id Organisator-ID im Mitglied der value Eigenschaft.

        Beispiel: Antwortnutzlast zum Abrufen der Transkript-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"
    }
]
}

        In diesem Beispiel ist die Transkript-ID MSMjMCMjMDEyNjJmNjgtOTc2Zi00MzIxLTlhNDQtYThmMmY4ZjQ1ZjVh.

      2. Zugreifen auf und Abrufen des Besprechungstranskripts basierend auf der Transkript-ID:

        Verwenden Sie das folgende Beispiel, um die Transkriptionen für eine bestimmte Besprechung im .vtt Format anzufordern:

         GET https://graph.microsoft.com/beta/users('14b779ae-cb64-47e7-a512-52fd50a4154d')/onlineMeetings('MSoxNGI3NzlhZS1jYjY0LTQ3ZTctYTUxMi01MmZkNTBhNDE1NGQqMCoqMTk6bWVldGluZ19ObVUwTlRreFl6TXRNMlkyTXkwME56UmxMV0ZtTjJZdE5URmlNR001T1dNM1pqWTJAdGhyZWFkLnYy')/transcripts('MSMjMCMjMDEyNjJmNjgtOTc2Zi00MzIxLTlhNDQtYThmMmY4ZjQ1ZjVh')/content?$format=text/vtt

        Die Antwortnutzlast enthält die Transkripte im .vtt Format.

    • Zum Abrufen von Aufzeichnungen müssen Sie Folgendes ausführen:

      1. Abrufen der Aufzeichnungs-ID basierend auf der Organisator-ID und der Besprechungs-ID:

        Verwenden Sie das folgende Beispiel, um die Aufzeichnungs-ID anzufordern:

        GET  https://graph.microsoft.com/beta/users/b935e675-5e67-48b9-8d45-249d5f88e964/onlineMeetings/MSpiOTM1ZTY3NS01ZTY3LTQ4YjktOGQ0NS0yNDlkNWY4OGU5NjQqMCoqMTk6bWVldGluZ19ZbU0zTnpJNU9USXRZakU0WlMwME1tUTNMVGt6TVRRdFkyWm1PRGRtWmpsaVptRTNAdGhyZWFkLnYy/recordings/

        In diesem Beispiel:

        • Die Besprechungs-ID ist als Wert für onlineMeetingsenthalten: MSpiOTM1ZTY3NS01ZTY3LTQ4YjktOGQ0NS0yNDlkNWY4OGU5NjQQMCoqMTk6bWVl dGluZ19ZbU0zTnpJNU9USXRZakU0WlMwME1tUTNMVGt6TVRRdFkyWm1 PRGRtWmpsaVptRTNAdGhyZWFkLnYy.
        • Die Organisator-ID lautet b935e675-5e67-48b9-8d45-249d5f88e964.

        Die Antwortnutzlast enthält die Aufzeichnungs-ID für die Besprechungs-ID und die id Organisator-ID im Mitglied der value -Eigenschaft.

        Beispiel: Antwortnutzlast zum Abrufen der Aufzeichnungs-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"
    }
]
}

        In diesem Beispiel lautet die Aufzeichnungs-ID 7e31db25-bc6e-4fd8-96c7-e01264e9b6fc.

      2. Zugreifen auf und Abrufen der Besprechungsaufzeichnung basierend auf der Aufzeichnungs-ID:

        Verwenden Sie das folgende Beispiel, um die Aufzeichnungen für eine bestimmte Besprechung im .mp4 Format anzufordern:

        GET https://graph.microsoft.com/beta/users/b935e675-5e67-48b9-8d45-249d5f88e964/onlineMeetings/MSpiOTM1ZTY3NS01ZTY3LTQ4YjktOGQ0NS0yNDlkNWY4OGU5NjQqMCoqMTk6bWVldGluZ19ZbU0zTnpJNU9USXRZakU0WlMwME1tUTNMVGt6TVRRdFkyWm1PRGRtWmpsaVptRTNAdGhyZWFkLnYy/recordings/7e31db25-bc6e-4fd8-96c7-e01264e9b6fc/content?$format=video/mp4

        Die Antwortnutzlast enthält die Aufzeichnungen im .mp4 Format.

Verwenden von Bot-Framework zum Abrufen von Besprechungs-ID und Organisator-ID

Ihre App kann das Bot-Framework verwenden, um die Besprechungs-ID und Organisator-ID abzurufen. Der Bot kann Besprechungsstart- oder -endereignisse automatisch von allen geplanten Onlinebesprechungen empfangen.

Verwenden Sie das folgende Beispiel, um die Besprechungs-ID und Organisator-ID mithilfe einer Bot-App abzurufen:

GET /v1/meetings/{meetingId}

Die Antwortnutzlast enthält:

  • Die Besprechungs-ID im msGraphResourceId Mitglied der details Eigenschaft.
  • Die Organisator-ID im id Element der organizer Eigenschaft.
Beispiel
: Antwortnutzlast zum Abrufen von Besprechungsdetails 
{
  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",
  },
}

In diesem Beispiel:

  • Die Besprechungs-ID ist als Wert für msGraphResourceIdenthalten: MSo2NzAyYWZiNi0xMDliLTRjMzItYTE0MS02ZTY1NDY5NTAyYjkqMCoqMTk6bWVl dGluZ19OV00xTVRJNU56TXROamd6TXlusMFlXUTRMVGht1dRdFpUZzNNVEJtT1RnM 1ltVXpAdGhyZWFkLnYy.
  • Die Organisator-ID ist als Wert für aadObjectIdorganizerenthalten: 6702afb6-109b-4c32-a141-6e65469502b9.

Nachdem Ihre App die Besprechungs-ID und die Organisator-ID abgerufen hat, löst sie die Graph-APIs aus, um Transkriptinhalte und Aufzeichnungen mithilfe dieser Besprechungsdetails abzurufen.

Codebeispiele

Sie können das folgende Codebeispiel für eine Bot-App ausprobieren:

Beispielname Beschreibung .NET Node.js
Besprechungstranskription Dies ist eine Beispielanwendung, die veranschaulicht, wie Sie das Besprechungstranskript mithilfe der Graph-API abrufen und im Dialogfeld anzeigen (in TeamsJS v1.x als Aufgabenmodul bezeichnet). View View
Besprechungstranskript und -aufzeichnung Dies ist eine Beispielanwendung, die veranschaulicht, wie Sie besprechungstranskripte und -aufzeichnungen mithilfe der Graph-API abrufen. View View
Registerkarte Besprechungsaufzeichnung und Transkript mit automatischer Aufzeichnung In diesem Codebeispiel wird veranschaulicht, wie Sie eine Besprechungs-App für die automatische Aufzeichnung und automatische Transkription erstellen und konfigurieren. View -

Nächster Schritt

Graph-APIs zum Abrufen von Transkriptionen

Graph-APIs zum Abrufen von Aufzeichnungen

Siehe auch