このガイドでは、Google Meet REST API を使用して、会議で生成されたさまざまな会議アーティファクトの詳細を取得する方法について説明します。
アーティファクトとは、会議に応答して Google Meet によって生成されるファイルまたはデータです。これには、動画や文字起こしなどのその他のアーティファクトが含まれます。
アーティファクトを生成するには、会議が終了する前に参加者が Meet で生成する必要があります。文字起こしは録画とは独立して動作します。文字起こしを生成するために会議を録画する必要はありません。詳しくは、ビデオ会議を録画すると Google Meet で文字起こしを使用するをご覧ください。
会議スペースのオーナーまたは参加者は、recordings
、transcripts
、transcripts.entries
リソースで get()
メソッドと list()
メソッドを呼び出してアーティファクトを取得できます。
ユーザー認証情報で認証と承認を行うと、Google 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
フィールドの値は files
リソースの id
に対応しています。詳細については、ファイルのダウンロードとエクスポートをご覧ください。
State
オブジェクトには、録音セッションのステータスが保持されます。これにより、録音が開始されたかどうか、録音が終了したが録音ファイルの準備ができていないかどうか、録音ファイルが生成され、ダウンロードの準備ができているかどうかをクエリできます。
録画の詳細を取得する
特定の録画の詳細を取得するには、name
パス パラメータを使用して recordings
リソースの get()
メソッドを使用します。録音名がわからない場合は、list()
メソッドを使用してすべての録音名を一覧表示できます。
このメソッドは、recordings
リソースのインスタンスを返します。
次のコードサンプルは、特定の録音を取得する方法を示しています。
Java
Node.js
Python
録音名は、会議レコード内の特定の録音 ID の名前に置き換えます。
すべての録音を一覧表示する
会議レコード内のすべての録画の詳細を一覧表示するには、parent
パス パラメータを使用して recordings
リソースの list()
メソッドを使用します。形式: conferenceRecords/{conferenceRecord}
。
このメソッドは、recordings
リソースのインスタンスとして、会議録音のリストを startTime
で昇順で返します。ページサイズを調整するには、ページネーションをカスタマイズする をご覧ください。
次のコードサンプルは、会議レコード内のすべての録音を一覧表示する方法を示しています。
Java
Node.js
Python
親の値は、会議レコードの名前に置き換えます。
成績証明
以降のセクションでは、会議レコードの会議音声文字変換に関する情報を取得する方法について説明します。
文字起こしデータが生成されると、Meet は文字起こし ID にアクセスできるようになります。ユーザーがドライブから文字起こしファイルを削除しても、Meet で一意の名前が返される場合があります。
transcripts
リソースには、DocsDestination
オブジェクトと State
オブジェクトの両方が含まれます。
DocsDestination
オブジェクトには、Google ドキュメントの文字起こしファイルが保存されるドライブのエクスポート ロケーションが保持されます。コンテンツを取得したり、ブラウザで文字起こしを閲覧したりするには、オブジェクトの exportUri
フィールド値を使用します。Google Docs API に精通している場合、document
フィールド値は documents
リソースの documentId
に対応しています。
State
オブジェクトには、音声文字変換セッションのステータスが保持されます。これにより、音声文字変換セッションが開始されたかどうか、音声文字変換セッションが終了したが音声文字変換ファイルの準備ができていないかどうか、音声文字変換ファイルが生成され、ダウンロードの準備ができているかどうかをクエリできます。
文字起こしの詳細を取得する
特定の文字起こしの詳細を取得するには、name
パス パラメータを使用して transcripts
リソースの get()
メソッドを使用します。文字起こしの名前がわからない場合は、list()
メソッドを使用してすべての文字起こしの名前を一覧表示できます。
このメソッドは、transcripts
リソースのインスタンスを返します。
次のコードサンプルは、特定の文字起こしを取得する方法を示しています。
Java
Node.js
Python
文字起こし名は、会議レコード内の特定の文字起こし ID の名前に置き換えます。
すべての文字起こしを一覧表示する
会議レコード内のすべての文字起こしの詳細を一覧表示するには、parent
パス パラメータを使用して transcripts
リソースの list()
メソッドを使用します。形式: conferenceRecords/{conferenceRecord}
。
このメソッドは、会議の文字起こしのリストを transcripts
リソースのインスタンスの形で返します。このリストは startTime
で昇順に並べ替えられます。ページサイズを調整するには、ページネーションをカスタマイズする をご覧ください。
次のコードサンプルは、会議レコード内のすべての音声文字変換を一覧表示する方法を示しています。
Java
Node.js
Python
親の値は、会議レコードの名前に置き換えます。
文字起こしエントリ
以降のセクションでは、会議の文字起こしセッション中に各参加者の音声を文字起こしエントリとして取得する方法について詳しく説明します。
文字起こしエントリには、参加者の音声の文字起こしテキストが最大 10,000 語含まれます。音声テキスト languageCode
(en-US
など)も、IETF BCP 47 構文として含まれます。
各文字起こしエントリは、会議の participant
名に関連付けられています。参加者の詳細を取得するには、参加者の詳細を取得するをご覧ください。
文字起こしエントリのデータは、会議の終了後 30 日間利用できます。
Meet REST API から返される文字起こしエントリは、ドキュメントの文字起こしファイルにある文字起こしと一致しない場合があります。これは、生成後に文字起こしファイルが変更された場合に発生します。
文字起こしエントリの詳細を取得する
特定の文字起こしエントリの詳細を取得するには、name
パス パラメータを使用して transcripts.entries
リソースの get()
メソッドを使用します。文字起こしエントリ名がわからない場合は、list()
メソッドを使用してすべての文字起こし名を一覧表示できます。
このメソッドは、transcripts.entries
リソースのインスタンスを返します。
次のコードサンプルは、特定の文字変換エントリを取得する方法を示しています。
Java
Node.js
Python
文字起こしエントリ名は、文字起こし内の特定の文字起こしエントリ ID の名前に置き換えます。
すべての文字起こしエントリを一覧表示する
文字起こし内のすべての文字起こしエントリの詳細を一覧表示するには、parent
パス パラメータを使用して transcripts.entries
リソースの list()
メソッドを使用します。形式: conferenceRecords/{conferenceRecord}/transcripts/{transcript}
。
このメソッドは、会議の文字起こしごとに構造化された文字起こしエントリのリストを、startTime
で昇順に並べ替えて、transcripts.entries
リソースのインスタンスとして返します。ページサイズを調整するには、ページネーションをカスタマイズする をご覧ください。
次のコードサンプルは、音声文字変換内のすべての音声文字変換エントリを一覧表示する方法を示しています。
Java
Node.js
Python
親の値は、会議レコードの名前と文字起こしの名前に置き換えます。
ページネーションをカスタマイズする
次のクエリ パラメータを渡して、録音、文字起こし、文字起こしエントリのページネーションをカスタマイズします。
pageSize
: 返されるアイテムの最大数。サービスが返す値はこれよりも少ないことがあります。指定されていない場合は、最大で 10 個のアイテムが返されます。最大値は 100 です。100 を超える値は自動的に 100 に変更されます。pageToken
: 前の list 呼び出しから受け取ったページトークン。後続のページを取得するには、このトークンを指定します。