Graph API を使用してトランスクリプトをフェッチする

  • [アーティクル]

Graph REST API を使用して、特定の会議のトランスクリプトを取得します。 アプリは、会議の開催者のユーザー ID と会議 ID に基づいてトランスクリプトをフェッチします。

トランスクリプトのフェッチには、次の API が使用されます。

List callTranscripts

この API は、ユーザー ID と会議 ID に基づいてすべての callTranscript オブジェクトの一覧を取得するために使用されます。 会議のトランスクリプトのメタデータを返します。これには、トランスクリプト ID とそのトランスクリプトの作成日時が含まれます。

HTTP 要求

GET /me/onlineMeetings('{meetingId}')/transcripts
GET /users('{userId}')/onlineMeetings('{meetingId}')/transcripts

オプションのクエリ パラメーター

メソッドは、 $skipToken および $topOData クエリ パラメーター をサポートし、応答のカスタマイズに役立ちます。

サポートされているクエリ パターン

パターン サポート 構文 メモ
サーバー側の改ページ位置の自動修正 ✓ @odata.nextLink 結果セットが複数のページにまたがる場合は、応答で継続トークンを取得します。
ページの制限 ✓ /transcripts?$top=20 ページ サイズ 20 のトランスクリプトを取得します。 既定のページ制限は 10 です。 ページの上限は 100 です。

要求ヘッダー

ヘッダー 値
Authorization ベアラー {token}。 必須です。

要求本文

このメソッドには、要求本文を指定しません。

応答

成功した場合、このメソッドは 200 OK 応答コードと、応答本文で callTranscript オブジェクトのコレクションを返します。


例: callTranscript の一覧
要求 
GET https://graph.microsoft.com/beta/users/ba321e0d-79ee-478d-8e28-85a19507f456/onlineMeetings/MSo1N2Y5ZGFjYy03MWJmLTQ3NDMtYjQxMy01M2EdFGkdRWHJlQ/transcripts

Response

注:

ここに示す応答オブジェクトは、読みやすさのために短縮されている可能性があります。

HTTP/1.1 200 OK
Content-Type: application/json

{
    "@odata.context": "https://graph.microsoft.com/beta/$metadata#users('ba321e0d-79ee-478d-8e28-85a19507f456')/onlineMeetings('MSo1N2Y5ZGFjYy03MWJmLTQ3NDMtYjQxMy01M2EdFGkdRWHJlQ')/transcripts",
    "@odata.count": 3,
    "@odata.nextLink": "https://graph.microsoft.com/beta/users('ba321e0d-79ee-478d-8e28-85a19507f456')/onlineMeetings('MSo1N2Y5ZGFjYy03MWJmLTQ3NDMtYjQxMy01M2EdFGkdRWHJlQ')/transcripts?$skiptoken=MSMjMCMjMjAyMS0wOS0xNlQxMzo1OToyNy4xMjEwMzgzWg%3d%3d",
    "value": [
        {
            "id": "MSMjMCMjZDAwYWU3NjUtNmM2Yi00NjQxLTgwMWQtMTkzMmFmMjEzNzdh",
            "createdDateTime": "2021-09-17T06:09:24.8968037Z"
        },
        {
            "id": "MSMjMCMjMzAxNjNhYTctNWRmZi00MjM3LTg5MGQtNWJhYWZjZTZhNWYw",
            "createdDateTime": "2021-09-16T18:58:58.6760692Z"
        },
        {
            "id": "MSMjMCMjNzU3ODc2ZDYtOTcwMi00MDhkLWFkNDItOTE2ZDNmZjkwZGY4",
            "createdDateTime": "2021-09-16T18:56:00.9038309Z"
        }        
    ]
}

Get callTranscript

アプリは、List callTranscripts API の応答として受信したトランスクリプト ID の一覧を解析して、必要なトランスクリプト ID を取得します。 この API は、ユーザー ID、会議 ID、およびトランスクリプト ID に基づいて 1 つのトランスクリプト メタデータを取得するために使用されます。

HTTP 要求

GET me/onlineMeetings('{meetingId}')/transcripts('{transcriptId}')
GET users('{userId}')/onlineMeetings('{meetingId}')/transcripts('{transcriptId}')

要求ヘッダー

ヘッダー 値
Authorization ベアラー {token}。 必須です。

要求本文

このメソッドには、要求本文を指定しません。

応答

成功した場合、このメソッドは 200 OK 応答コードと、応答本文でcallTranscript オブジェクトを返します。


例: callTranscript を取得する
要求 
GET https://graph.microsoft.com/beta/users/ba321e0d-79ee-478d-8e28-85a19507f456/onlineMeetings/MSo1N2Y5ZGFjYy03MWJmLTQ3NDMtYjQxMy01M2EdFGkdRWHJlQ/transcripts/MSMjMCMjNzU3ODc2ZDYtOTcwMi00MDhkLWFkNDItOTE2ZDNmZjkwZGY4

Response

注:

ここに示す応答オブジェクトは、読みやすさのために短縮されている可能性があります。

HTTP/1.1 200 OK
Content-type: application/json

{
    "@odata.context": "https://graph.microsoft.com/beta/$metadata#users('ba321e0d-79ee-478d-8e28-85a19507f456')/onlineMeetings('MSo1N2Y5ZGFjYy03MWJmLTQ3NDMtYjQxMy01M2EdFGkdRWHJlQ')/transcripts/$entity",
    "id": "MSMjMCMjNzU3ODc2ZDYtOTcwMi00MDhkLWFkNDItOTE2ZDNmZjkwZGY4",
    "createdDateTime": "2021-09-17T06:09:24.8968037Z"
}

Get callTranscript content

この API は、Get callTranscript API の応答で取得された、選択したトランスクリプト ID のトランスクリプトを取得するために使用されます。 トランスクリプトの内容を返します。

HTTP 要求

GET me/onlineMeetings('{meetingId}')/transcripts('{transcriptId}')/content
GET users('{userId}')/onlineMeetings('{meetingId}')/transcripts('{transcriptId}')/content

オプションのクエリ パラメーター

このメソッドは、応答のカスタマイズを$format可能にする OData クエリ パラメーターをサポートします。

サポートされている形式の種類は、vtt に対する text/vtt、または docx に対する application/vnd.openxmlformats-officedocument.wordprocessingml.document 形式です。

要求ヘッダー

ヘッダー 値
Authorization ベアラー {token}。 必須です。
承諾 text/vtt OR application/vnd.openxmlformats-officedocument.wordprocessingml.document. オプション。

要求本文

このメソッドには、要求本文を指定しません。

Response

成功した場合、このメソッドは 200 OK 応答コードと、応答本文で callTranscript オブジェクトの特定のバイトを返します。 content-type ヘッダーでは、トランスクリプト コンテンツの種類を指定します。

例

例: callTranscript コンテンツを取得する
要求 
GET https://graph.microsoft.com/beta/users/ba321e0d-79ee-478d-8e28-85a19507f456/onlineMeetings/MSo1N2Y5ZGFjYy03MWJmLTQ3NDMtYjQxMy01M2EdFGkdRWHJlQ/transcripts/MSMjMCMjNzU3ODc2ZDYtOTcwMi00MDhkLWFkNDItOTE2ZDNmZjkwZGY4/content

Response

応答には、本文内のトランスクリプトのバイトが含まれます。 content-type ヘッダーでは、トランスクリプト コンテンツの種類を指定します。

注:

ここに示す応答オブジェクトは、読みやすさのために短縮されている可能性があります。

HTTP/1.1 200 OK
Content-type: text/vtt

WEBVTT
    
0:0:0.0 --> 0:0:5.320
<v User Name>This is a transcript test.</v>

例: クエリ パラメーターを指定する callTranscript コンテンツ$format取得する
要求 
GET https://graph.microsoft.com/beta/users/ba321e0d-79ee-478d-8e28-85a19507f456/onlineMeetings/MSo1N2Y5ZGFjYy03MWJmLTQ3NDMtYjQxMy01M2EdFGkdRWHJlQ/transcripts/MSMjMCMjNzU3ODc2ZDYtOTcwMi00MDhkLWFkNDItOTE2ZDNmZjkwZGY4/content?$format=text/vtt

Response

応答には、本文内のトランスクリプトのバイトが含まれます。 content-type ヘッダーでは、トランスクリプト コンテンツの種類を指定します。

注:

ここに示す応答オブジェクトは、読みやすさのために短縮されている可能性があります。

HTTP/1.1 200 OK
Content-type: text/vtt
    
WEBVTT
    
0:0:0.0 --> 0:0:5.320
<v User Name>This is a transcript test.</v>

例: Accept ヘッダーを指定する callTranscript コンテンツを取得する
要求 
GET https://graph.microsoft.com/beta/users/ba321e0d-79ee-478d-8e28-85a19507f456/onlineMeetings/MSo1N2Y5ZGFjYy03MWJmLTQ3NDMtYjQxMy01M2EdFGkdRWHJlQ/transcripts/MSMjMCMjNzU3ODc2ZDYtOTcwMi00MDhkLWFkNDItOTE2ZDNmZjkwZGY4/content
Accept: application/vnd.openxmlformats-officedocument.wordprocessingml.document

Response

応答には、本文内のトランスクリプトのバイトが含まれます。 content-Type ヘッダーでは、トランスクリプト コンテンツの種類を指定します。

注:

ここに示す応答オブジェクトは、読みやすさのために短縮されている可能性があります。

HTTP/1.1 200 OK
Content-type: application/vnd.openxmlformats-officedocument.wordprocessingml.document
    
0:0:0.0 --> 0:0:5.320
User Name
This is a transcript test.

例: accept ヘッダーよりも優先順位を取得$format callTranscript コンテンツを取得する
要求 
GET https://graph.microsoft.com/beta/users/ba321e0d-79ee-478d-8e28-85a19507f456/onlineMeetings/MSo1N2Y5ZGFjYy03MWJmLTQ3NDMtYjQxMy01M2EdFGkdRWHJlQ/transcripts/MSMjMCMjNzU3ODc2ZDYtOTcwMi00MDhkLWFkNDItOTE2ZDNmZjkwZGY4/content?$format=text/vtt
Accept: application/vnd.openxmlformats-officedocument.wordprocessingml.document

Response

応答には、本文内のトランスクリプトのバイトが含まれます。 content-Type ヘッダーでは、トランスクリプト コンテンツの種類を指定します。

注:

ここに示す応答オブジェクトは、読みやすさのために短縮されている可能性があります。

HTTP/1.1 200 OK
Content-type: text/vtt
    
WEBVTT
   
0:0:0.0 --> 0:0:5.320
<v User Name>This is a transcript test.</v>