このガイドでは、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}
。
このメソッドは、startTime
で昇順に並べ替えられた会議録画のリストを recordings
リソースのインスタンスとして返します。ページサイズを調整するには、ページネーションをカスタマイズする をご覧ください。
次のコードサンプルは、会議レコード内のすべての録音を一覧表示する方法を示しています。
Java
Node.js
Python
parent 値は、会議レコードの名前に置き換えます。
成績証明
以降のセクションでは、会議レコードで会議の文字起こしに関する情報を取得する方法について詳しく説明します。
文字起こしデータが生成されると、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}
。
このメソッドは、startTime
で昇順に並べ替えられた会議文字起こしのリストを transcripts
リソースのインスタンスとして返します。ページサイズを調整するには、ページネーションをカスタマイズする をご覧ください。
次のコードサンプルは、会議レコード内のすべての文字起こしを一覧表示する方法を示しています。
Java
Node.js
Python
parent 値は、会議レコードの名前に置き換えます。
文字起こしエントリ
以降のセクションでは、会議の文字起こしセッション中に各参加者の発言を文字起こしエントリとして取得する方法について詳しく説明します。
文字起こしエントリには、参加者の音声の文字起こしテキストが含まれます(最大 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
: 前回のリスト呼び出しから受け取ったページトークン。後続のページを取得するには、このトークンを指定します。