このドキュメントでは、Google Meet REST API を使用して、会議で生成されたさまざまな会議アーティファクトの詳細を取得する方法について説明します。
アーティファクトとは、会議に応じて Google Meet によって生成されるファイルまたはデータです 。これには、動画の録画や文字起こしなどの他のアーティファクトが含まれます。
アーティファクトを生成するには、会議の終了前に参加者が Meet でアーティファクトを構成する必要があります。詳細については、自動 アーティファクトを管理するをご覧ください。
文字起こしは録画とは独立して動作するため、文字起こしを生成するために会議を録画する必要はありません。すべての参加者が会議から退出すると、文字起こしは自動的に停止します。詳しくは、ビデオ会議を録画するおよびGoogle Meet で文字起こしを使用するをご覧ください。
アーティファクトを取得する
会議スペースのオーナーまたは参加者は、recordings、transcripts、transcripts.entries、および
smart notes リソースで get および
list メソッドを呼び出して、アーティファクトを取得できます。詳細については、以降のセクションをご覧ください。
ユーザー 認証情報を使用して認証と認可を行うと、 Meet アプリはユーザーデータにアクセスし、 認証されたユーザーの代わりにオペレーションを実行できます。ドメイン全体の委任で認証すると、アプリケーションのサービス アカウントによるユーザーのデータへのアクセスを承認できます。これにより、ユーザーごとに同意を求める必要がなくなります。
アーティファクトの保持
会議が終了すると、Meet は録画と文字起こしを会議の主催者の Google ドライブに保存します。デフォルトでは、Meet アーティファクトはドライブのルールに従って保持されます。
Meet REST API によって提供される文字起こしエントリは、会議の終了から 30 日後に削除されます。
Google Vault の Meet 固有の保持ルールを使用して、Meet アーティファクトの保持を個別に管理することもできます。詳しくは、Vault を使用して Google Meet のデータを保持するをご覧ください。
録画
以降のセクションでは、会議レコードの録画に関する情報を取得する方法について説明します。
録画ファイルが生成されると、Meet は録画 ID にアクセスできます。ユーザーが Google ドライブから録画ファイルを削除しても、Meet には一意の名前が返されます。
recordings
リソースには、
DriveDestination
オブジェクトと
State
オブジェクトの両方が含まれます。
DriveDestination オブジェクトには、録画が MP4 ファイルとして保存されるドライブ内のエクスポート場所が保持されます。録画をダウンロードするか、
ブラウザで再生するには、オブジェクトの
exportUri
フィールド値を使用します。Google Drive API に精通している場合、
file
フィールド値は
id フィールドに
files リソースに対応します。詳しくは、ファイルをダウンロードしてエクスポートするをご覧ください。
State オブジェクトには、レコーディング セッションのステータスが保持されます。これにより、録画が開始されたかどうか、録画は終了したが録画ファイルが準備できていないかどうか、録画ファイルが生成されてダウンロードの準備ができているかどうかをクエリできます。
録画の詳細を取得する
特定の録画の詳細を取得するには、
get
リソースで
recordings
メソッドを使用します。name パスパラメータを conferenceRecords/{conferenceRecord}/recordings/{recordingName} の形式で設定します。
録画名がわからない場合は、すべての録画
名をlistメソッドを使用して一覧表示できます。
このメソッドは、recordings リソースのインスタンスを返します。
次のコードサンプルは、特定の録画を取得する方法を示しています。
Java
Node.js
Python
cURL
curl -X GET "https://meet.googleapis.com/v2/conferenceRecords/CONFERENCE_RECORD_NAME/recordings/RECORDING_NAME" \
-H "Authorization: Bearer ACCESS_TOKEN"
ACCESS_TOKEN は、API へのアクセスを許可するアクセス トークンに置き換えます。
次のように置き換えます。
- 会議レコード名: 会議レコード内の特定の会議 ID の名前。
- 録画名: 会議レコード内の特定の録画 ID の名前。
すべての録画を一覧表示する
会議レコード内のすべての録画の詳細を一覧表示するには、
list
メソッドを
recordings
リソースで使用します。parent パスパラメータを conferenceRecords/{conferenceRecord} の形式で設定します。
このメソッドは、会議の録画のリストを recordings リソースのインスタンスとして返します。このリストは、startTime の昇順で並べ替えられます。ページサイズを調整するには、ページネーションをカスタマイズする をご覧ください。
次のコードサンプルは、会議レコード内のすべての録画を一覧表示する方法を示しています。
Java
Node.js
Python
cURL
curl -X GET "https://meet.googleapis.com/v2/conferenceRecords/PARENT_NAME/recordings" \
-H "Authorization: Bearer ACCESS_TOKEN"
ACCESS_TOKEN は、API へのアクセスを許可するアクセス トークンに置き換えます。
親の名前は、会議レコード内の特定の会議 ID の名前に置き換えます。
文字起こし
以降のセクションでは、会議レコードの会議の文字起こしに関する情報を取得する方法について説明します。
文字起こしデータが生成されると、Meet は文字起こし ID にアクセスできます。ユーザーがドライブから文字起こしファイルを削除しても、Meet には一意の名前が返されます。
transcripts
リソースには、
DocsDestination
オブジェクトと
State
オブジェクトの両方が含まれます。
DocsDestination オブジェクトには、Google ドキュメントの文字起こしファイルが保存されるドライブ内のエクスポート場所が保持されます。コンテンツを取得するか、ブラウザで文字起こしを参照するには、オブジェクトの
exportUri
フィールド値を使用します。Google ドキュメント API に精通している場合、
document
フィールド値は
documentId
リソースの documentsに対応します。
State オブジェクトには、文字起こしセッションのステータスが保持されます。これにより、文字起こしセッションが開始されたかどうか、文字起こしセッションは終了したが文字起こしファイルが準備できていないかどうか、文字起こしファイルが生成されてダウンロードの準備ができているかどうかをクエリできます。
文字起こしの詳細を取得する
特定の文字起こしの詳細を取得するには、
get
リソースで
transcripts
メソッドを使用します。name パスパラメータを conferenceRecords/{conferenceRecord}/transcripts/{transcriptName} の形式で設定します。
文字起こし名がわからない場合は、すべての文字起こし
名を list メソッドを使用して一覧表示できます。
このメソッドは、transcripts リソースのインスタンスを返します。
次のコードサンプルは、特定の文字起こしを取得する方法を示しています。
Java
Node.js
Python
cURL
curl -X GET "https://meet.googleapis.com/v2/conferenceRecords/CONFERENCE_RECORD_NAME/transcripts/TRANSCRIPT_NAME" \
-H "Authorization: Bearer ACCESS_TOKEN"
ACCESS_TOKEN は、API へのアクセスを許可するアクセス トークンに置き換えます。
次のように置き換えます。
- 会議レコード名: 会議レコード内の特定の会議 ID の名前。
- 文字起こし名: 会議レコード内の特定の文字起こし ID の名前。
すべての文字起こしを一覧表示する
会議レコード内のすべての文字起こしの詳細を一覧表示するには、
list
メソッドを
transcripts
リソースで使用します。parent パスパラメータを conferenceRecords/{conferenceRecord} の形式で設定します。
このメソッドは、会議の文字起こしのリストを transcripts リソースのインスタンスとして返します。このリストは、startTime の昇順で並べ替えられます。ページサイズを調整するには、ページネーションをカスタマイズする をご覧ください。
次のコードサンプルは、会議レコード内のすべての文字起こしを一覧表示する方法を示しています。
Java
Node.js
Python
cURL
curl -X GET "https://meet.googleapis.com/v2/conferenceRecords/PARENT_NAME/transcripts" \
-H "Authorization: Bearer ACCESS_TOKEN"
ACCESS_TOKEN は、API へのアクセスを許可するアクセス トークンに置き換えます。
親の名前は、会議レコード内の特定の会議 ID の名前に置き換えます。
文字起こしエントリ
以降のセクションでは、会議の文字起こしセッション中に各参加者の発言を文字起こしエントリとして取得する方法について説明します。
文字起こしエントリには、参加者の音声の文字起こしテキストが最大 10,000 語まで含まれます。発話されたテキストの languageCode(en-USなど)
も、IETF BCP 47 構文として含まれます。
各文字起こしエントリは、会議の participant 名に関連付けられています。参加者の詳細を取得するには、参加者の詳細を取得するをご覧ください。
文字起こしエントリ データは、会議の終了から 30 日間利用できます。
Meet REST API から返される文字起こしエントリは、ドキュメントの文字起こしファイルにある文字起こしと一致しない場合があります。これは、生成後に文字起こしファイルが変更された場合に発生します。
文字起こしエントリの詳細を取得する
特定の文字起こしエントリの詳細を取得するには、
get
リソースで
transcripts.entries
メソッドを使用します。name パスパラメータを conferenceRecords/{conferenceRecord}/transcripts/{transcriptName}/entries/{transcriptEntryName} の形式で設定します。
文字起こしエントリ名がわからない場合は、すべての文字起こしエントリ
名を list メソッドを使用して一覧表示できます。
このメソッドは、transcripts.entries リソースのインスタンスを返します。
次のコードサンプルは、特定の文字起こしエントリを取得する方法を示しています。
Java
Node.js
Python
cURL
curl -X GET "https://meet.googleapis.com/v2/conferenceRecords/CONFERENCE_RECORD_NAME/transcripts/TRANSCRIPT_NAME/entries/TRANSCRIPT_ENTRY_NAME" \
-H "Authorization: Bearer ACCESS_TOKEN"
ACCESS_TOKEN は、API へのアクセスを許可するアクセス トークンに置き換えます。
次のように置き換えます。
- 会議レコード名: 会議レコード内の特定の会議 ID の名前。
- 文字起こし名: 会議レコード内の特定の文字起こし ID の名前。
- 文字起こしエントリ名: 文字起こし内の特定の文字起こしエントリ ID の名前。
すべての文字起こしエントリを一覧表示する
文字起こし内のすべての文字起こしエントリの詳細を一覧表示するには、
list
リソースで
transcripts.entries
メソッドを使用します。parent パスパラメータを conferenceRecords/{conferenceRecord}/transcripts/{transcript} の形式で設定します。
このメソッドは、会議の文字起こしごとに構造化された文字起こしエントリのリストを transcripts.entries リソースのインスタンスとして返します。このリストは、startTime の昇順で並べ替えられます。ページサイズを調整するには、ページネーションを
カスタマイズする をご覧ください。
次のコードサンプルは、文字起こし内のすべての文字起こしエントリを一覧表示する方法を示しています。
Java
Node.js
Python
cURL
curl -X GET "https://meet.googleapis.com/v2/conferenceRecords/PARENT_NAME/transcripts/TRANSCRIPT_NAME/entries" \
-H "Authorization: Bearer ACCESS_TOKEN"
ACCESS_TOKEN は、API へのアクセスを許可するアクセス トークンに置き換えます。
次のように置き換えます。
- 親の名前: 会議レコード内の特定の会議 ID の名前。
- 文字起こし名: 会議レコード内の特定の文字起こし ID の名前。
スマートメモ
以降のセクションでは、会議レコードの会議のスマートメモに関する情報を取得する方法について説明します。
スマートメモデータが生成されると、Meet はスマートメモ ID にアクセスできます。ユーザーがドライブからスマートメモファイルを削除しても、Meet には一意の名前が返されます。
smartNotes
リソースには
State
オブジェクトが含まれます。このオブジェクトには、スマートメモ セッションのステータスが保持されます。これにより、スマートメモ セッションが開始されたかどうか、スマートメモ セッションは終了したがスマートメモ ファイルが準備できていないかどうか、スマートメモ ファイルが生成されてダウンロードの準備ができているかどうかをクエリできます。
smartNotes リソースには、
DocsDestination
オブジェクト タイプも含まれます。このオブジェクトには、Google ドキュメントのスマートメモ ファイルが保存されるドライブ内のエクスポート場所が保持されます。コンテンツを取得するか、ブラウザでスマートメモを参照するには、オブジェクトの
exportUri
フィールド値を使用します。Google ドキュメント API に精通している場合、
document
フィールド値は
documentId
リソースの documentsに対応します。
スマートメモは、get および
list メソッドを使用して管理できます。
スマートメモの詳細を取得する
特定のスマートメモ ファイルの詳細を取得するには、
get
メソッドを smartNotes リソースで使用します。name パスパラメータを conferenceRecords/{conferenceRecord}/smartNotes/{smartNote} の形式で設定します。
スマートメモの名前がわからない場合は、すべてのスマートメモ
ファイルをlist メソッドを使用して一覧表示できます。
このメソッドは、smartNotes リソースのインスタンスを返します。
cURL
curl -X GET "https://meet.googleapis.com/v2beta/conferenceRecords/CONFERENCE_RECORD_NAME/smartNotes/SMART_NOTES_NAME" \
-H "Authorization: Bearer ACCESS_TOKEN"
次のように置き換えます。
- CONFERENCE_RECORD_NAME:会議レコード内の特定の会議 ID。
- SMART_NOTES_NAME:会議レコード内の特定のスマートメモ ID。
- ACCESS_TOKEN: API へのアクセスを許可するアクセス トークン。
すべてのスマートメモを一覧表示する
会議レコード内のすべてのスマートメモ ファイルの詳細を一覧表示するには、
list
リソースで smartNotes メソッドを使用します。parent パスパラメータを conferenceRecords/{conferenceRecord} の形式で設定します。
このメソッドは、会議のスマートメモ ファイルのリストを smartNotes リソースのインスタンスとして返します。このリストは、startTime の昇順で並べ替えられます。ページサイズを調整するには、ページネーションをカスタマイズする をご覧ください。
cURL
curl -X GET "https://meet.googleapis.com/v2beta/conferenceRecords/PARENT_NAME/smartNotes" \
-H "Authorization: Bearer ACCESS_TOKEN"
次のように置き換えます。
- PARENT_NAME: 会議レコード内の特定の会議 ID。
- ACCESS_TOKEN: API へのアクセスを許可するアクセス トークン。
ページネーションをカスタマイズする
録画、文字起こし、文字起こしエントリのページネーションをカスタマイズするには、次のクエリ パラメータを渡します。
pageSize: 返されるアイテムの最大数。サービスが返す値はこれよりも少ないことがあります。指定されていない場合、最大で 10 個のアイテムが返されます。最大値は 100 です。100 を超える値は自動的に 100 に変更されます。pageToken: 前回のリスト呼び出しから受け取ったページトークン。後続のページを取得するには、このトークンを指定します。