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

[アーティクル]
04/04/2023

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

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

List callTranscripts
Get callTranscript
Get callTranscript content

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

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

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

サポートされている形式の種類は、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>

次の方法で共有

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

List callTranscripts

Get callTranscript

Get callTranscript content

その他のリソース