Microsoft Graph を使用して会議のトランスクリプトとレコーディングの変更通知を取得する

[アーティクル]
11/07/2024

変更通知を使用すると、トランスクリプトと記録の変更をサブスクライブできます。オンライン会議の後にトランスクリプトまたはレコーディングを利用できる場合は常に通知を受け取ることができます。

この記事では、 トランスクリプト と記録リソースのシナリオについて説明します。詳細については、「 Microsoft Teams リソースの通知を変更する」を参照してください。

注:

今後 1 時間を超えるサブスクリプション の有効期限DateTime を要求する場合は、サブスクリプション要求に lifecycleNotificationUrl プロパティを含めることによってライフサイクル通知をサブスクライブする必要があります。それ以外の場合、サブスクリプション要求は次のエラーメッセージで失敗します。 expirationDateTime 値が 1 時間を超えると、このリソースでサブスクリプションを作成するには lifecycleNotificationUrl が必要です。

テナント内のオンライン会議で使用できるトランスクリプトの変更通知を取得するには、をサブスクライブします communications/onlineMeetings/getAllTranscripts。このリソースは、通知へのリソースデータの組み込みをサポートします。トランスクリプトの通知は、文字起こしが開始される前にサブスクリプションが発生した場合にのみ送信されます。このサブスクリプションは、スケジュールされた onlineMeetings をサポートしますが、チャネル会議はサポートしていません。

アクセス許可

をサブスクライブ communications/onlineMeetings/getAllTranscriptsするには、次のいずれかのアクセス許可が必要です。アクセス許可の選択方法などの詳細については、「アクセス許可」を参照してください。

アクセス許可の種類	アクセス許可 (特権の小さいものから大きいものへ)
委任 (職場または学校のアカウント)	サポートされていません。
委任 (個人用 Microsoft アカウント)	サポートされていません。
アプリケーション	OnlineMeetingTranscript.Read.All

例

次の例は、テナントレベルで使用可能なトランスクリプトをサブスクライブする方法を示しています。

POST https://graph.microsoft.com/v1.0/subscriptions
Content-Type: application/json

{
  "changeType": "created",
  "notificationUrl": "https://webhook.azurewebsites.net/api/resourceNotifications",
  "resource": "communications/onlineMeetings/getAllTranscripts",
  "includeResourceData": true,
  "encryptionCertificate": "{base64encodedCertificate}",
  "encryptionCertificateId": "{customId}",
  "expirationDateTime": "2023-03-20T11:00:00.0000000Z",
  "clientState": "{secretClientState}"
}

特定のオンライン会議で使用できるトランスクリプトの変更通知を取得するには、をサブスクライブします communications/onlineMeetings/{onlineMeetingId}/transcripts。このリソースは、通知へのリソースデータの組み込みをサポートします。トランスクリプトの通知は、文字起こしが開始される前にサブスクリプションが発生した場合にのみ送信されます。このサブスクリプションは、スケジュールされた onlineMeetings をサポートしますが、チャネル会議はサポートしていません。

アクセス許可

をサブスクライブ communications/onlineMeetings/{onlineMeetingId}/transcriptsするには、次のいずれかのアクセス許可が必要です。アクセス許可の選択方法などの詳細については、「アクセス許可」を参照してください。

アクセス許可の種類	アクセス許可 (特権の小さいものから大きいものへ)
委任 (職場または学校のアカウント)	OnlineMeetingTranscript.Read.All
委任 (個人用 Microsoft アカウント)	サポートされていません。
アプリケーション	OnlineMeetingTranscript.Read.Chat,OnlineMeetingTranscript.Read.All

注:

OnlineMeetingTranscript.Read.Chat アクセス許可では、リソース固有の同意が使用されます。
必要なリソース固有の同意アクセス許可のみを使用して、特定のオンライン会議で使用できるトランスクリプトをサブスクライブするには、リソース文字列と共に useResourceSpecificConsentBasedAuthorization=true クエリパラメーターを使用します。

POST https://graph.microsoft.com/v1.0/subscriptions
Content-Type: application/json

{
  "changeType": "created",
  "notificationUrl": "https://webhook.azurewebsites.net/api/resourceNotifications",
  "resource": "communications/onlineMeetings/{onlineMeetingId}/transcripts",
  "includeResourceData": true,
  "encryptionCertificate": "{base64encodedCertificate}",
  "encryptionCertificateId": "{customId}",
  "expirationDateTime": "2023-03-20T11:00:00.0000000Z",
  "clientState": "{secretClientState}"
}

POST https://graph.microsoft.com/v1.0/subscriptions
Content-Type: application/json

{
  "changeType": "created",
  "notificationUrl": "https://webhook.azurewebsites.net/api/resourceNotifications",
  "resource": "communications/onlineMeetings/{onlineMeetingId}/transcripts?useResourceSpecificConsentBasedAuthorization=true",
  "includeResourceData": true,
  "encryptionCertificate": "{base64encodedCertificate}",
  "encryptionCertificateId": "{customId}",
  "expirationDateTime": "2023-03-20T11:00:00.0000000Z",
  "clientState": "{secretClientState}"
}

特定のユーザーが開催したオンライン会議で使用できるトランスクリプトの変更通知を取得するには、をサブスクライブします users/{userId}/onlineMeetings/getAllTranscripts。このリソースは、通知へのリソースデータの組み込みをサポートします。トランスクリプトの通知は、文字起こしが開始される前にサブスクリプションが発生した場合にのみ送信されます。このサブスクリプションは、スケジュールされた onlineMeetings をサポートしますが、チャネル会議はサポートしていません。

アクセス許可

をサブスクライブ users/{userId}/onlineMeetings/getAllTranscriptsするには、次のいずれかのアクセス許可が必要です。アクセス許可の選択方法などの詳細については、「アクセス許可」を参照してください。

アクセス許可の種類	アクセス許可 (特権の小さいものから大きいものへ)
委任 (職場または学校のアカウント)	OnlineMeetingTranscript.Read.All
委任 (個人用 Microsoft アカウント)	サポートされていません。
アプリケーション	OnlineMeetingTranscript.Read.All

例

次の例は、特定のユーザーが開催するオンライン会議で使用できるトランスクリプトをサブスクライブする方法を示しています。

POST https://graph.microsoft.com/v1.0/subscriptions
Content-Type: application/json

{
  "changeType": "created",
  "notificationUrl": "https://webhook.azurewebsites.net/api/resourceNotifications",
  "resource": "users/{userId}/onlineMeetings/getAllTranscripts",
  "includeResourceData": true,
  "encryptionCertificate": "{base64encodedCertificate}",
  "encryptionCertificateId": "{customId}",
  "expirationDateTime": "2023-03-20T11:00:00.0000000Z",
  "clientState": "{secretClientState}"
}

特定の Teams アプリがインストールされているオンライン会議で使用できるトランスクリプトの変更通知を取得するには、をサブスクライブします appCatalogs/teamsApps/{teams-app-id}/installedToOnlineMeetings/getAllTranscripts。このリソースは、通知へのリソースデータの組み込みをサポートします。トランスクリプトの通知は、文字起こしが開始される前にサブスクリプションが発生した場合にのみ送信されます。このサブスクリプションは、スケジュールされた onlineMeetings をサポートしますが、チャネル会議はサポートしていません。

注:

このリソースの種類は、エンドポイントでのみ /beta 使用できます。

アクセス許可

をサブスクライブ appCatalogs/teamsApps/{teams-app-id}/installedToOnlineMeetings/getAllTranscriptsするには、次のいずれかのアクセス許可が必要です。アクセス許可の選択方法などの詳細については、「アクセス許可」を参照してください。

アクセス許可の種類	アクセス許可 (特権の小さいものから大きいものへ)
委任 (職場または学校のアカウント)	サポートされていません。
委任 (個人用 Microsoft アカウント)	サポートされていません。
アプリケーション	OnlineMeetingTranscript.Read.Chat,OnlineMeetingTranscript.Read.All

注:

OnlineMeetingTranscript.Read.Chat アクセス許可では、リソース固有の同意が使用されます。
必要なリソース固有の同意アクセス許可のみを使用して特定の Teams アプリがインストールされているオンライン会議で使用できるトランスクリプトをサブスクライブするには、リソース文字列と共に useResourceSpecificConsentBasedAuthorization=true クエリパラメーターを使用します。

POST https://graph.microsoft.com/beta/subscriptions
Content-Type: application/json
{
  "changeType": "created",
  "notificationUrl": "https://webhook.azurewebsites.net/api/resourceNotifications",
  "resource": "appCatalogs/teamsApps/386bbcdb-1e1c-4f3f-b7d0-ad7b9ea6cf7c/installedToOnlineMeetings/getAllTranscripts",
  "includeResourceData": true,
  "encryptionCertificate": "{base64encodedCertificate}",
  "encryptionCertificateId": "{customId}",
  "expirationDateTime": "2023-03-20T11:00:00.0000000Z",
  "clientState": "{secretClientState}"
}

POST https://graph.microsoft.com/beta/subscriptions
Content-Type: application/json
{
  "changeType": "created",
  "notificationUrl": "https://webhook.azurewebsites.net/api/resourceNotifications",
  "resource": "appCatalogs/teamsApps/386bbcdb-1e1c-4f3f-b7d0-ad7b9ea6cf7c/installedToOnlineMeetings/getAllTranscripts?useResourceSpecificConsentBasedAuthorization=true",
  "includeResourceData": true,
  "encryptionCertificate": "{base64encodedCertificate}",
  "encryptionCertificateId": "{customId}",
  "expirationDateTime": "2023-03-20T11:00:00.0000000Z",
  "clientState": "{secretClientState}"
}

テナント内のオンライン会議で使用できる記録の変更通知を取得するには、をサブスクライブします communications/onlineMeetings/getAllRecordings。このリソースは、通知へのリソースデータの組み込みをサポートします。このサブスクリプションは、スケジュールされた onlineMeetings をサポートしますが、チャネル会議はサポートしていません。

アクセス許可

をサブスクライブ communications/onlineMeetings/getAllRecordingsするには、次のいずれかのアクセス許可が必要です。アクセス許可の選択方法などの詳細については、「アクセス許可」を参照してください。

アクセス許可の種類	アクセス許可 (特権の小さいものから大きいものへ)
委任 (職場または学校のアカウント)	サポートされていません。
委任 (個人用 Microsoft アカウント)	サポートされていません。
アプリケーション	OnlineMeetingRecording.Read.All

例

次の例は、テナントレベルで使用可能な記録をサブスクライブする方法を示しています。

POST https://graph.microsoft.com/v1.0/subscriptions
Content-Type: application/json

{
  "changeType": "created",
  "notificationUrl": "https://webhook.azurewebsites.net/api/resourceNotifications",
  "resource": "communications/onlineMeetings/getAllRecordings",
  "includeResourceData": true,
  "encryptionCertificate": "{base64encodedCertificate}",
  "encryptionCertificateId": "{customId}",
  "expirationDateTime": "2023-04-11T11:00:00.0000000Z",
  "clientState": "{secretClientState}"
}

特定のオンライン会議で使用できる記録の変更通知を取得するには、をサブスクライブします communications/onlineMeetings/{onlineMeetingId}/recordings。このリソースは、通知へのリソースデータの組み込みをサポートします。このサブスクリプションは、スケジュールされた onlineMeetings をサポートしますが、チャネル会議はサポートしていません。

アクセス許可

をサブスクライブ communications/onlineMeetings/{onlineMeetingId}/recordingsするには、次のいずれかのアクセス許可が必要です。アクセス許可の選択方法などの詳細については、「アクセス許可」を参照してください。

アクセス許可の種類	アクセス許可 (特権の小さいものから大きいものへ)
委任 (職場または学校のアカウント)	OnlineMeetingRecording.Read.All
委任 (個人用 Microsoft アカウント)	サポートされていません。
アプリケーション	OnlineMeetingRecording.Read.Chat, OnlineMeetingRecording.Read.All

注:

OnlineMeetingRecording.Read.Chat アクセス許可では、リソース固有の同意が使用されます。
必要なリソース固有の同意アクセス許可のみを使用して、特定のオンライン会議で使用できる記録をサブスクライブするには、リソース文字列と共に useResourceSpecificConsentBasedAuthorization=true クエリパラメーターを使用します。

POST https://graph.microsoft.com/v1.0/subscriptions
Content-Type: application/json

{
  "changeType": "created",
  "notificationUrl": "https://webhook.azurewebsites.net/api/resourceNotifications",
  "resource": "communications/onlineMeetings/{onlineMeetingId}/recordings",
  "includeResourceData": true,
  "encryptionCertificate": "{base64encodedCertificate}",
  "encryptionCertificateId": "{customId}",
  "expirationDateTime": "2023-04-11T11:00:00.0000000Z",
  "clientState": "{secretClientState}"
}

POST https://graph.microsoft.com/v1.0/subscriptions
Content-Type: application/json

{
  "changeType": "created",
  "notificationUrl": "https://webhook.azurewebsites.net/api/resourceNotifications",
  "resource": "communications/onlineMeetings/{onlineMeetingId}/recordings?useResourceSpecificConsentBasedAuthorization=true",
  "includeResourceData": true,
  "encryptionCertificate": "{base64encodedCertificate}",
  "encryptionCertificateId": "{customId}",
  "expirationDateTime": "2023-04-11T11:00:00.0000000Z",
  "clientState": "{secretClientState}"
}

特定のユーザーが開催したオンライン会議で使用できる記録の変更通知を取得するには、をサブスクライブします users/{userId}/onlineMeetings/getAllRecordings。このリソースは、通知へのリソースデータの組み込みをサポートします。このサブスクリプションは、スケジュールされた onlineMeetings をサポートしますが、チャネル会議はサポートしていません。

アクセス許可

をサブスクライブ users/{userId}/onlineMeetings/getAllRecordingsするには、次のいずれかのアクセス許可が必要です。アクセス許可の選択方法などの詳細については、「アクセス許可」を参照してください。

アクセス許可の種類	アクセス許可 (特権の小さいものから大きいものへ)
委任 (職場または学校のアカウント)	OnlineMeetingRecording.Read.All
委任 (個人用 Microsoft アカウント)	サポートされていません。
アプリケーション	OnlineMeetingRecording.Read.All

例

次の例は、特定のユーザーが開催するオンライン会議で使用できる記録をサブスクライブする方法を示しています。

POST https://graph.microsoft.com/v1.0/subscriptions
Content-Type: application/json

{
  "changeType": "created",
  "notificationUrl": "https://webhook.azurewebsites.net/api/resourceNotifications",
  "resource": "users/{userId}/onlineMeetings/getAllRecordings",
  "includeResourceData": true,
  "encryptionCertificate": "{base64encodedCertificate}",
  "encryptionCertificateId": "{customId}",
  "expirationDateTime": "2023-04-11T11:00:00.0000000Z",
  "clientState": "{secretClientState}"
}

特定の Teams アプリがインストールされているオンライン会議で使用できる記録の変更通知を取得するには、をサブスクライブします appCatalogs/teamsApps/{teams-app-id}/installedToOnlineMeetings/getAllRecordings。このリソースは、通知へのリソースデータの組み込みをサポートします。このサブスクリプションは、スケジュールされた onlineMeetings をサポートしますが、チャネル会議はサポートしていません。

注:

このリソースの種類は、エンドポイントでのみ /beta 使用できます。

アクセス許可

をサブスクライブ appCatalogs/teamsApps/{teams-app-id}/installedToOnlineMeetings/getAllRecordingsするには、次のいずれかのアクセス許可が必要です。アクセス許可の選択方法などの詳細については、「アクセス許可」を参照してください。

アクセス許可の種類	アクセス許可 (特権の小さいものから大きいものへ)
委任 (職場または学校のアカウント)	サポートされていません。
委任 (個人用 Microsoft アカウント)	サポートされていません。
アプリケーション	OnlineMeetingRecording.Read.Chat, OnlineMeetingRecording.Read.All

注:

OnlineMeetingRecording.Read.Chat アクセス許可では、リソース固有の同意が使用されます。
必要なリソース固有の同意アクセス許可のみを使用して特定の Teams アプリがインストールされているオンライン会議で使用できる記録をサブスクライブするには、リソース文字列と共に useResourceSpecificConsentBasedAuthorization=true クエリパラメーターを使用します。

POST https://graph.microsoft.com/beta/subscriptions
Content-Type: application/json
{
  "changeType": "created",
  "notificationUrl": "https://webhook.azurewebsites.net/api/resourceNotifications",
  "resource": "appCatalogs/teamsApps/386bbcdb-1e1c-4f3f-b7d0-ad7b9ea6cf7c/installedToOnlineMeetings/getAllRecordings",
  "includeResourceData": true,
  "encryptionCertificate": "{base64encodedCertificate}",
  "encryptionCertificateId": "{customId}",
  "expirationDateTime": "2023-03-20T11:00:00.0000000Z",
  "clientState": "{secretClientState}"
}

POST https://graph.microsoft.com/beta/subscriptions
Content-Type: application/json
{
  "changeType": "created",
  "notificationUrl": "https://webhook.azurewebsites.net/api/resourceNotifications",
  "resource": "appCatalogs/teamsApps/386bbcdb-1e1c-4f3f-b7d0-ad7b9ea6cf7c/installedToOnlineMeetings/getAllRecordings?useResourceSpecificConsentBasedAuthorization=true",
  "includeResourceData": true,
  "encryptionCertificate": "{base64encodedCertificate}",
  "encryptionCertificateId": "{customId}",
  "expirationDateTime": "2023-03-20T11:00:00.0000000Z",
  "clientState": "{secretClientState}"
}

通知のペイロード

サブスクリプションに応じて、リソースデータの有無にかかわらず通知を受け取ることができます。リソースデータをサブスクライブすると、通知と共にトランスクリプトまたは記録メタデータを取得できます。

リソースデータを使用した通知

リソースデータを含む通知の場合、ペイロードは次のようになります。このペイロードは、オンライン会議で使用できるトランスクリプト用です。

{
  "value": [
    {
      "subscriptionId": "516220d0-0f88-46cc-ac39-02b687687526",
      "changeType": "created",
      "clientState": "<<--SpecifiedClientState-->>",
      "subscriptionExpirationDateTime": "2023-09-17T08:13:26.3265566+00:00",
      "resource": "communications/onlineMeetings('MSo5NzZmNGIzMS1mZDAxLTRlMGItOTE3OC0yOWNjNDBjMTQ0MzgqMCoqMTk6bWVldGluZ19aalk0TXpRNU9UQXRZamxqWWkwMFpESXdMVGczTkdZdFptUTNNRGhtWm1FMk9EVTNAdGhyZWFkLnYy')/transcripts('MSMjMCMjOGIzMmI0MzktY2QxNy00ODc1LTg1NWQtYzA1MDM0ZmFkZWMx')",
      "resourceData": {
        "id": "MSMjMCMjOGIzMmI0MzktY2QxNy00ODc1LTg1NWQtYzA1MDM0ZmFkZWMx",
        "@odata.type": "#Microsoft.Graph.callTranscript",
        "@odata.id": "communications/onlineMeetings('MSo5NzZmNGIzMS1mZDAxLTRlMGItOTE3OC0yOWNjNDBjMTQ0MzgqMCoqMTk6bWVldGluZ19aalk0TXpRNU9UQXRZamxqWWkwMFpESXdMVGczTkdZdFptUTNNRGhtWm1FMk9EVTNAdGhyZWFkLnYy')/transcripts('MSMjMCMjOGIzMmI0MzktY2QxNy00ODc1LTg1NWQtYzA1MDM0ZmFkZWMx')"
      },
      "encryptedContent": {
        "data": "<<--EncryptedContent-->>",
        "dataKey": "<<--EnryptedDataKeyUsedForEncryptingContent-->>",
        "encryptionCertificateId": "<<--IdOfTheCertificateUsedForEncryptingDataKey-->>",
        "encryptionCertificateThumbprint": "<<--ThumbprintOfTheCertificateUsedForEncryptingDataKey-->>"
      },
      "tenantId": "<<--TenantForWhichNotificationWasSent-->>"
    }
  ],
  "validationTokens": [
    "<<--ValidationTokens-->>"
  ]
}

復号化された通知のペイロードは次のようになります。ペイロードはトランスクリプトスキーマに準拠しています。ペイロードは、GET 操作によって返されるペイロードと似ています。

{
  "id": "MSMjMCMjOGIzMmI0MzktY2QxNy00ODc1LTg1NWQtYzA1MDM0ZmFkZWMx",
  "meetingId": "MSo5NzZmNGIzMS1mZDAxLTRlMGItOTE3OC0yOWNjNDBjMTQ0MzgqMCoqMTk6bWVldGluZ19aalk0TXpRNU9UQXRZamxqWWkwMFpESXdMVGczTkdZdFptUTNNRGhtWm1FMk9EVTNAdGhyZWFkLnYy",
  "callId": "af630fe0-04d3-4559-8cf9-91fe45e36296",
  "transcriptContentUrl": "communications/onlineMeetings/MSo5NzZmNGIzMS1mZDAxLTRlMGItOTE3OC0yOWNjNDBjMTQ0MzgqMCoqMTk6bWVldGluZ19aalk0TXpRNU9UQXRZamxqWWkwMFpESXdMVGczTkdZdFptUTNNRGhtWm1FMk9EVTNAdGhyZWFkLnYy/transcripts/MSMjMCMjOGIzMmI0MzktY2QxNy00ODc1LTg1NWQtYzA1MDM0ZmFkZWMx/content",
  "createdDateTime": null,
  "endDateTime": "2023-04-10T08:27:25.2346000Z",
  "contentCorrelationId": "bc842d7a-2f6e-4b18-a1c7-73ef91d5c8e3",
  "meetingOrganizer": {
    "application": null,
    "device": null,
    "user": {
      "userIdentityType": "aadUser",
      "id": "976f4b31-fd01-4e0b-9178-29cc40c14438",
      "displayName": null,
      "tenantId": "2432b57b-0abd-43db-aa7b-16eadd115d34"
    }
  }
}

リソースデータを含む通知の場合、ペイロードは次のようになります。このペイロードは、オンライン会議で使用できる記録用です。

{
  "value": [
    {
      "subscriptionId": "7a62d59e-a789-4dd7-9c85-cf7d6567890d",
      "changeType": "created",
      "clientState": "<<--SpecifiedClientState-->>",
      "subscriptionExpirationDateTime": "2023-09-17T08:20:06.9211285+00:00",
      "resource": "communications/onlineMeetings('MSo5NzZmNGIzMS1mZDAxLTRlMGItOTE3OC0yOWNjNDBjMTQ0MzgqMCoqMTk6bWVldGluZ19NMk0zTlRReFkySXRaamsyWmkwME5UTTRMV0l4TTJFdE1EQmtPV1E1TW1Rek0yRXhAdGhyZWFkLnYy')/recordings('VjIjIzE5NzZmNGIzMS1mZDAxLTRlMGItOTE3OC0yOWNjNDBjMTQ0MzgyNDMyYjU3Yi0wYWJkLTQzZGItYWE3Yi0xNmVhZGQxMTVkMzQwNDAwMDAwMDgyMDBFMDAwNzRDNUI3MTAxQTgyRTAwODAwMDAwMDAwMDZhODllMWZkYmJlZDkwMTAwMDAwMDAwMDAwMDAwMDAxMDAwMDAwMDA5NzUzYzg5ZWI3MmJkNDJiYWZjMTVkZDA4NWNmNWJlIyNjZmNjNTBjMy0zODllLTQyOTUtOWRiNy1mMjkwYWY2NDJlNzI=')",
      "resourceData": {
        "id": "VjIjIzE5NzZmNGIzMS1mZDAxLTRlMGItOTE3OC0yOWNjNDBjMTQ0MzgyNDMyYjU3Yi0wYWJkLTQzZGItYWE3Yi0xNmVhZGQxMTVkMzQwNDAwMDAwMDgyMDBFMDAwNzRDNUI3MTAxQTgyRTAwODAwMDAwMDAwMDZhODllMWZkYmJlZDkwMTAwMDAwMDAwMDAwMDAwMDAxMDAwMDAwMDA5NzUzYzg5ZWI3MmJkNDJiYWZjMTVkZDA4NWNmNWJlIyNjZmNjNTBjMy0zODllLTQyOTUtOWRiNy1mMjkwYWY2NDJlNzI=",
        "@odata.type": "#Microsoft.Graph.callRecording",
        "@odata.id": "communications/onlineMeetings('MSo5NzZmNGIzMS1mZDAxLTRlMGItOTE3OC0yOWNjNDBjMTQ0MzgqMCoqMTk6bWVldGluZ19NMk0zTlRReFkySXRaamsyWmkwME5UTTRMV0l4TTJFdE1EQmtPV1E1TW1Rek0yRXhAdGhyZWFkLnYy')/recordings('VjIjIzE5NzZmNGIzMS1mZDAxLTRlMGItOTE3OC0yOWNjNDBjMTQ0MzgyNDMyYjU3Yi0wYWJkLTQzZGItYWE3Yi0xNmVhZGQxMTVkMzQwNDAwMDAwMDgyMDBFMDAwNzRDNUI3MTAxQTgyRTAwODAwMDAwMDAwMDZhODllMWZkYmJlZDkwMTAwMDAwMDAwMDAwMDAwMDAxMDAwMDAwMDA5NzUzYzg5ZWI3MmJkNDJiYWZjMTVkZDA4NWNmNWJlIyNjZmNjNTBjMy0zODllLTQyOTUtOWRiNy1mMjkwYWY2NDJlNzI=')"
      },
      "encryptedContent": {
        "data": "<<--EncryptedContent-->>",
        "dataKey": "<<--EnryptedDataKeyUsedForEncryptingContent-->>",
        "encryptionCertificateId": "<<--IdOfTheCertificateUsedForEncryptingDataKey-->>",
        "encryptionCertificateThumbprint": "<<--ThumbprintOfTheCertificateUsedForEncryptingDataKey-->>"
      },
      "tenantId": "<<--TenantForWhichNotificationWasSent-->>"
    }
  ],
  "validationTokens": [
    "<<--ValidationTokens-->>"
  ]
}

復号化された通知のペイロードは次のようになります。ペイロードは、記録スキーマに準拠しています。ペイロードは、GET 操作によって返されるペイロードと似ています。

{
  "id": "VjIjIzE5NzZmNGIzMS1mZDAxLTRlMGItOTE3OC0yOWNjNDBjMTQ0MzgyNDMyYjU3Yi0wYWJkLTQzZGItYWE3Yi0xNmVhZGQxMTVkMzQwNDAwMDAwMDgyMDBFMDAwNzRDNUI3MTAxQTgyRTAwODAwMDAwMDAwMDZhODllMWZkYmJlZDkwMTAwMDAwMDAwMDAwMDAwMDAxMDAwMDAwMDA5NzUzYzg5ZWI3MmJkNDJiYWZjMTVkZDA4NWNmNWJlIyNjZmNjNTBjMy0zODllLTQyOTUtOWRiNy1mMjkwYWY2NDJlNzI=",
  "meetingId": "MSo5NzZmNGIzMS1mZDAxLTRlMGItOTE3OC0yOWNjNDBjMTQ0MzgqMCoqMTk6bWVldGluZ19NMk0zTlRReFkySXRaamsyWmkwME5UTTRMV0l4TTJFdE1EQmtPV1E1TW1Rek0yRXhAdGhyZWFkLnYy",
  "callId": "af630fe0-04d3-4559-8cf9-91fe45e36296",
  "createdDateTime": "2023-07-25T09:35:02.85022Z",
  "endDateTime": "2023-04-10T08:27:25.2346000Z",
  "contentCorrelationId": "bc842d7a-2f6e-4b18-a1c7-73ef91d5c8e3",
  "recordingContentUrl": "communications/onlineMeetings/MSo5NzZmNGIzMS1mZDAxLTRlMGItOTE3OC0yOWNjNDBjMTQ0MzgqMCoqMTk6bWVldGluZ19NMk0zTlRReFkySXRaamsyWmkwME5UTTRMV0l4TTJFdE1EQmtPV1E1TW1Rek0yRXhAdGhyZWFkLnYy/recordings/VjIjIzE5NzZmNGIzMS1mZDAxLTRlMGItOTE3OC0yOWNjNDBjMTQ0MzgyNDMyYjU3Yi0wYWJkLTQzZGItYWE3Yi0xNmVhZGQxMTVkMzQwNDAwMDAwMDgyMDBFMDAwNzRDNUI3MTAxQTgyRTAwODAwMDAwMDAwMDZhODllMWZkYmJlZDkwMTAwMDAwMDAwMDAwMDAwMDAxMDAwMDAwMDA5NzUzYzg5ZWI3MmJkNDJiYWZjMTVkZDA4NWNmNWJlIyNjZmNjNTBjMy0zODllLTQyOTUtOWRiNy1mMjkwYWY2NDJlNzI=/content",
  "meetingOrganizer": {
    "application": null,
    "device": null,
    "user": {
      "userIdentityType": "aadUser",
      "id": "976f4b31-fd01-4e0b-9178-29cc40c14438",
      "displayName": null,
      "tenantId": "2432b57b-0abd-43db-aa7b-16eadd115d34"
    }
  },
  "content": null
}

リソースデータを使用しない通知

リソースデータのない通知では、トランスクリプトまたは記録を取得するために GET 呼び出しを行うリソース ID が提供されます。リソースデータのない通知のサブスクリプションでは、暗号化証明書は必要ありません (実際のリソースデータは送信されないため)。

リソースデータを使用しない通知の場合、ペイロードは次のようになります。このペイロードは、オンライン会議で使用できるトランスクリプト用です。

{
  "subscriptionId": "0cc28c98-4d2a-4a34-b850-815d7e6486ea",
  "changeType": "created",
  "tenantId": "<<--TenantForWhichNotificationWasSent-->>",
  "clientState": "<<--SpecifiedClientState-->>",
  "subscriptionExpirationDateTime": "2023-09-17T08:29:11.3173971+00:00",
  "resource": "communications/onlineMeetings('MSo5NzZmNGIzMS1mZDAxLTRlMGItOTE3OC0yOWNjNDBjMTQ0MzgqMCoqMTk6bWVldGluZ19aalk0TXpRNU9UQXRZamxqWWkwMFpESXdMVGczTkdZdFptUTNNRGhtWm1FMk9EVTNAdGhyZWFkLnYy')/transcripts('MSMjMCMjOGIzMmI0MzktY2QxNy00ODc1LTg1NWQtYzA1MDM0ZmFkZWMx')",
  "resourceData": {
    "id": "MSMjMCMjOGIzMmI0MzktY2QxNy00ODc1LTg1NWQtYzA1MDM0ZmFkZWMx",
    "@odata.type": "#Microsoft.Graph.callTranscript",
    "@odata.id": "communications/onlineMeetings('MSo5NzZmNGIzMS1mZDAxLTRlMGItOTE3OC0yOWNjNDBjMTQ0MzgqMCoqMTk6bWVldGluZ19aalk0TXpRNU9UQXRZamxqWWkwMFpESXdMVGczTkdZdFptUTNNRGhtWm1FMk9EVTNAdGhyZWFkLnYy')/transcripts('MSMjMCMjOGIzMmI0MzktY2QxNy00ODc1LTg1NWQtYzA1MDM0ZmFkZWMx')"
  }
}

リソースデータを使用しない通知の場合、ペイロードは次のようになります。このペイロードは、オンライン会議で使用できる記録用です。

{
  "subscriptionId": "6aa5ced2-0a5a-4643-9274-3109c731d986",
  "changeType": "created",
  "tenantId": "<<--TenantForWhichNotificationWasSent-->>",
  "clientState": "<<--SpecifiedClientState-->>",
  "subscriptionExpirationDateTime": "2023-09-17T08:27:05.0241757+00:00",
  "resource": "communications/onlineMeetings('MSo5NzZmNGIzMS1mZDAxLTRlMGItOTE3OC0yOWNjNDBjMTQ0MzgqMCoqMTk6bWVldGluZ19NMk0zTlRReFkySXRaamsyWmkwME5UTTRMV0l4TTJFdE1EQmtPV1E1TW1Rek0yRXhAdGhyZWFkLnYy')/recordings('VjIjIzE5NzZmNGIzMS1mZDAxLTRlMGItOTE3OC0yOWNjNDBjMTQ0MzgyNDMyYjU3Yi0wYWJkLTQzZGItYWE3Yi0xNmVhZGQxMTVkMzQwNDAwMDAwMDgyMDBFMDAwNzRDNUI3MTAxQTgyRTAwODAwMDAwMDAwMDZhODllMWZkYmJlZDkwMTAwMDAwMDAwMDAwMDAwMDAxMDAwMDAwMDA5NzUzYzg5ZWI3MmJkNDJiYWZjMTVkZDA4NWNmNWJlIyNjZmNjNTBjMy0zODllLTQyOTUtOWRiNy1mMjkwYWY2NDJlNzI=')",
  "resourceData": {
    "id": "VjIjIzE5NzZmNGIzMS1mZDAxLTRlMGItOTE3OC0yOWNjNDBjMTQ0MzgyNDMyYjU3Yi0wYWJkLTQzZGItYWE3Yi0xNmVhZGQxMTVkMzQwNDAwMDAwMDgyMDBFMDAwNzRDNUI3MTAxQTgyRTAwODAwMDAwMDAwMDZhODllMWZkYmJlZDkwMTAwMDAwMDAwMDAwMDAwMDAxMDAwMDAwMDA5NzUzYzg5ZWI3MmJkNDJiYWZjMTVkZDA4NWNmNWJlIyNjZmNjNTBjMy0zODllLTQyOTUtOWRiNy1mMjkwYWY2NDJlNzI=",
    "@odata.type": "#Microsoft.Graph.callRecording",
    "@odata.id": "communications/onlineMeetings('MSo5NzZmNGIzMS1mZDAxLTRlMGItOTE3OC0yOWNjNDBjMTQ0MzgqMCoqMTk6bWVldGluZ19NMk0zTlRReFkySXRaamsyWmkwME5UTTRMV0l4TTJFdE1EQmtPV1E1TW1Rek0yRXhAdGhyZWFkLnYy')/recordings('VjIjIzE5NzZmNGIzMS1mZDAxLTRlMGItOTE3OC0yOWNjNDBjMTQ0MzgyNDMyYjU3Yi0wYWJkLTQzZGItYWE3Yi0xNmVhZGQxMTVkMzQwNDAwMDAwMDgyMDBFMDAwNzRDNUI3MTAxQTgyRTAwODAwMDAwMDAwMDZhODllMWZkYmJlZDkwMTAwMDAwMDAwMDAwMDAwMDAxMDAwMDAwMDA5NzUzYzg5ZWI3MmJkNDJiYWZjMTVkZDA4NWNmNWJlIyNjZmNjNTBjMy0zODllLTQyOTUtOWRiNy1mMjkwYWY2NDJlNzI=')"
  }
}

リソースと @odata.id プロパティを使用して、Microsoft Graph を呼び出してトランスクリプトまたは記録を取得できます。

次の方法で共有

Microsoft Graph を使用して会議のトランスクリプトとレコーディングの変更通知を取得する

アクセス許可

例

アクセス許可

アクセス許可

例

アクセス許可

アクセス許可

例

アクセス許可

アクセス許可

例

アクセス許可

通知のペイロード

リソースデータを使用した通知

リソースデータを使用しない通知

フィードバック

その他のリソース

次の方法で共有

Microsoft Graph を使用して会議のトランスクリプトとレコーディングの変更通知を取得する

テナント レベルで利用可能なトランスクリプトをサブスクライブする

アクセス許可

例

特定のオンライン会議で利用可能なトランスクリプトをサブスクライブする

アクセス許可

例 1: クラシック アクセス許可を使用して特定のオンライン会議で使用できるトランスクリプトをサブスクライブする

例 2: リソース固有の同意アクセス許可を使用して、特定のオンライン会議で使用できるトランスクリプトをサブスクライブする

ユーザー レベルで利用可能なトランスクリプトをサブスクライブする

アクセス許可

例

特定の Teams アプリがインストールされているオンライン会議で使用できるトランスクリプトをサブスクライブする

アクセス許可

例 1: クラシック アクセス許可を使用して特定の Teams アプリがインストールされているオンライン会議で使用できるトランスクリプトをサブスクライブする

例 2: リソース固有の同意アクセス許可のみを使用して特定の Teams アプリがインストールされているオンライン会議で使用できるトランスクリプトをサブスクライブする

テナント レベルで使用可能な記録をサブスクライブする

アクセス許可

例

特定のオンライン会議で使用できる録音をサブスクライブする

アクセス許可

例 1: クラシック アクセス許可を使用して、特定のオンライン会議で使用できる録音をサブスクライブする

例 2: リソース固有の同意アクセス許可のみを使用して、特定のオンライン会議で使用できる記録をサブスクライブする

ユーザー レベルで使用可能な記録をサブスクライブする

アクセス許可

例

特定の Teams アプリがインストールされているオンライン会議で使用できる記録をサブスクライブする

アクセス許可

例 1: 必要なクラシック アクセス許可を使用して特定の Teams アプリがインストールされているオンライン会議で使用できる録音をサブスクライブする

例 2: リソース固有の同意アクセス許可のみを使用して特定の Teams アプリがインストールされているオンライン会議で使用できる記録をサブスクライブする

通知のペイロード

リソース データを使用した通知

リソース データを使用しない通知

関連コンテンツ

フィードバック

その他のリソース

テナントレベルで利用可能なトランスクリプトをサブスクライブする

例 1: クラシックアクセス許可を使用して特定のオンライン会議で使用できるトランスクリプトをサブスクライブする

ユーザーレベルで利用可能なトランスクリプトをサブスクライブする

例 1: クラシックアクセス許可を使用して特定の Teams アプリがインストールされているオンライン会議で使用できるトランスクリプトをサブスクライブする

テナントレベルで使用可能な記録をサブスクライブする

例 1: クラシックアクセス許可を使用して、特定のオンライン会議で使用できる録音をサブスクライブする

ユーザーレベルで使用可能な記録をサブスクライブする

例 1: 必要なクラシックアクセス許可を使用して特定の Teams アプリがインストールされているオンライン会議で使用できる録音をサブスクライブする

リソースデータを使用した通知

リソースデータを使用しない通知