Utilizza gli artefatti

Questo documento spiega come ottenere dettagli sui diversi artefatti della riunione generati da una conferenza utilizzando l'API REST di Google Meet.

Un artefatto è un file o un dato generato da Google Meet in risposta a una conferenza. Sono inclusi registrazioni video e altri artefatti, come trascrizioni e appunti intelligenti.

Per produrre artefatti, i partecipanti devono configurarli in Meet prima della fine della conferenza. Per saperne di più, consulta Gestire gli artefatti automatici.

Le trascrizioni funzionano indipendentemente dalle registrazioni e non è necessario registrare la riunione per generare una trascrizione. Quando tutti i partecipanti lasciano la riunione, la trascrizione si interrompe automaticamente. Per ulteriori informazioni, vedi Registrare una riunione video e Utilizzare le trascrizioni con Google Meet.

Recuperare gli artefatti

Se sei il proprietario o un partecipante di uno spazio riunioni, puoi chiamare i metodi get e list nelle risorse recordings, transcripts, transcripts.entries e smartNotes per recuperare gli artefatti. Per saperne di più, consulta le sezioni seguenti.

L'autenticazione e l'autorizzazione con le credenziali utente consentono alle app Meet di accedere ai dati utente ed eseguire operazioni per conto dell'utente autenticato. L'autenticazione con la delega a livello di dominio ti consente di autorizzare l'account di servizio di un'applicazione ad accedere ai dati dei tuoi utenti senza richiedere il consenso di ciascun utente.

Conservazione degli artefatti

Al termine di una conferenza, Meet salva le registrazioni, le trascrizioni e gli appunti intelligenti su Google Drive dell'organizzatore della riunione. Per impostazione predefinita, gli artefatti di Meet vengono conservati in base alle regole di Drive.

Le voci della trascrizione fornite dall'API REST di Meet vengono eliminate 30 giorni dopo la fine della conferenza.

Puoi anche gestire la conservazione degli artefatti di Meet separatamente utilizzando regole di conservazione specifiche per Meet in Google Vault. Per saperne di più, vedi Conserva i dati di Google Meet con Vault.

Registrazioni

Le sezioni seguenti descrivono in dettaglio come ottenere informazioni sulle registrazioni in un record di conferenza.

Meet ha accesso all'ID registrazione dopo la generazione del file di registrazione. È possibile che un utente elimini il file di registrazione da Google Drive, ma il nome univoco viene comunque restituito in Meet.

La risorsa recordings include gli oggetti DriveDestination e State.

L'oggetto DriveDestination contiene la posizione di esportazione in Drive in cui la registrazione viene salvata come file MP4. Per scaricare la registrazione o riprodurla in un browser, utilizza il valore del campo exportUri dell'oggetto. Se hai familiarità con l'API Google Drive, il valore del campo file corrisponde al campo id nella risorsa files. Per maggiori informazioni, vedi Scaricare ed esportare file.

L'oggetto State contiene lo stato della sessione di registrazione. In questo modo puoi chiedere se la registrazione è iniziata, se è terminata ma il file non è pronto o se è stato generato ed è pronto per il download.

Visualizzare i dettagli di una registrazione

Per ottenere i dettagli di una registrazione specifica, utilizza il metodo get nella risorsa recordings. Imposta il parametro di percorso name utilizzando il formato conferenceRecords/{conferenceRecord}/recordings/{recordingName}.

Se non conosci il nome della registrazione, puoi elencare tutti i nomi delle registrazioni utilizzando il metodo list.

Il metodo restituisce un'istanza di una risorsa recordings.

Il seguente esempio di codice mostra come recuperare una registrazione specifica:

Java

java-meet/samples/snippets/generated/com/google/apps/meet/v2/conferencerecordsservice/getrecording/AsyncGetRecording.java
import com.google.api.core.ApiFuture;
import com.google.apps.meet.v2.ConferenceRecordsServiceClient;
import com.google.apps.meet.v2.GetRecordingRequest;
import com.google.apps.meet.v2.Recording;
import com.google.apps.meet.v2.RecordingName;

public class AsyncGetRecording {

  public static void main(String[] args) throws Exception {
    asyncGetRecording();
  }

  public static void asyncGetRecording() throws Exception {
    // This snippet has been automatically generated and should be regarded as a code template only.
    // It will require modifications to work:
    // - It may require correct/in-range values for request initialization.
    // - It may require specifying regional endpoints when creating the service client as shown in
    // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
    try (ConferenceRecordsServiceClient conferenceRecordsServiceClient =
        ConferenceRecordsServiceClient.create()) {
      GetRecordingRequest request =
          GetRecordingRequest.newBuilder()
              .setName(RecordingName.of("[CONFERENCE_RECORD]", "[RECORDING]").toString())
              .build();
      ApiFuture<Recording> future =
          conferenceRecordsServiceClient.getRecordingCallable().futureCall(request);
      // Do something.
      Recording response = future.get();
    }
  }
}

Node.js

packages/google-apps-meet/samples/generated/v2/conference_records_service.get_recording.js
/**
 * This snippet has been automatically generated and should be regarded as a code template only.
 * It will require modifications to work.
 * It may require correct/in-range values for request initialization.
 * TODO(developer): Uncomment these variables before running the sample.
 */
/**
 *  Required. Resource name of the recording.
 */
// const name = 'abc123'

// Imports the Meet library
const {ConferenceRecordsServiceClient} = require('@google-apps/meet').v2;

// Instantiates a client
const meetClient = new ConferenceRecordsServiceClient();

async function callGetRecording() {
  // Construct request
  const request = {
    name,
  };

  // Run request
  const response = await meetClient.getRecording(request);
  console.log(response);
}

callGetRecording();

Python

packages/google-apps-meet/samples/generated_samples/meet_v2_generated_conference_records_service_get_recording_async.py
# This snippet has been automatically generated and should be regarded as a
# code template only.
# It will require modifications to work:
# - It may require correct/in-range values for request initialization.
# - It may require specifying regional endpoints when creating the service
#   client as shown in:
#   https://googleapis.dev/python/google-api-core/latest/client_options.html
from google.apps import meet_v2


async def sample_get_recording():
    # Create a client
    client = meet_v2.ConferenceRecordsServiceAsyncClient()

    # Initialize request argument(s)
    request = meet_v2.GetRecordingRequest(
        name="name_value",
    )

    # Make the request
    response = await client.get_recording(request=request)

    # Handle the response
    print(response)

cURL

curl -X GET \
  "https://meet.googleapis.com/v2/conferenceRecords/CONFERENCE_RECORD_NAME/recordings/RECORDING_NAME" \
  -H "Authorization: Bearer ACCESS_TOKEN"

Sostituisci ACCESS_TOKEN con il token di accesso che concede l'accesso all'API.

Sostituisci quanto segue:

  • Il nome del record della conferenza con il nome dell'ID conferenza specifico in un record della conferenza.
  • Il nome della registrazione con il nome dell'ID registrazione specifico in un record della conferenza.

Elenco di tutte le registrazioni

Per elencare i dettagli di tutte le registrazioni in un record di conferenza, utilizza il metodo list nella risorsa recordings. Imposta il parametro di percorso parent utilizzando il formato conferenceRecords/{conferenceRecord}.

Il metodo restituisce un elenco di registrazioni di conferenze, ordinate per startTime in ordine crescente, come istanza di una risorsa recordings. Per regolare le dimensioni della pagina, vedi Personalizzare la paginazione.

Il seguente esempio di codice mostra come elencare tutte le registrazioni in un record di conferenza:

Java

java-meet/samples/snippets/generated/com/google/apps/meet/v2/conferencerecordsservice/listrecordings/AsyncListRecordings.java
import com.google.api.core.ApiFuture;
import com.google.apps.meet.v2.ConferenceRecordName;
import com.google.apps.meet.v2.ConferenceRecordsServiceClient;
import com.google.apps.meet.v2.ListRecordingsRequest;
import com.google.apps.meet.v2.Recording;

public class AsyncListRecordings {

  public static void main(String[] args) throws Exception {
    asyncListRecordings();
  }

  public static void asyncListRecordings() throws Exception {
    // This snippet has been automatically generated and should be regarded as a code template only.
    // It will require modifications to work:
    // - It may require correct/in-range values for request initialization.
    // - It may require specifying regional endpoints when creating the service client as shown in
    // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
    try (ConferenceRecordsServiceClient conferenceRecordsServiceClient =
        ConferenceRecordsServiceClient.create()) {
      ListRecordingsRequest request =
          ListRecordingsRequest.newBuilder()
              .setParent(ConferenceRecordName.of("[CONFERENCE_RECORD]").toString())
              .setPageSize(883849137)
              .setPageToken("pageToken873572522")
              .build();
      ApiFuture<Recording> future =
          conferenceRecordsServiceClient.listRecordingsPagedCallable().futureCall(request);
      // Do something.
      for (Recording element : future.get().iterateAll()) {
        // doThingsWith(element);
      }
    }
  }
}

Node.js

packages/google-apps-meet/samples/generated/v2/conference_records_service.list_recordings.js
/**
 * This snippet has been automatically generated and should be regarded as a code template only.
 * It will require modifications to work.
 * It may require correct/in-range values for request initialization.
 * TODO(developer): Uncomment these variables before running the sample.
 */
/**
 *  Required. Format: `conferenceRecords/{conference_record}`
 */
// const parent = 'abc123'
/**
 *  Maximum number of recordings to return. The service might return fewer
 *  than this value.
 *  If unspecified, at most 10 recordings are returned.
 *  The maximum value is 100; values above 100 are coerced to 100.
 *  Maximum might change in the future.
 */
// const pageSize = 1234
/**
 *  Page token returned from previous List Call.
 */
// const pageToken = 'abc123'

// Imports the Meet library
const {ConferenceRecordsServiceClient} = require('@google-apps/meet').v2;

// Instantiates a client
const meetClient = new ConferenceRecordsServiceClient();

async function callListRecordings() {
  // Construct request
  const request = {
    parent,
  };

  // Run request
  const iterable = meetClient.listRecordingsAsync(request);
  for await (const response of iterable) {
      console.log(response);
  }
}

callListRecordings();

Python

packages/google-apps-meet/samples/generated_samples/meet_v2_generated_conference_records_service_list_recordings_async.py
# This snippet has been automatically generated and should be regarded as a
# code template only.
# It will require modifications to work:
# - It may require correct/in-range values for request initialization.
# - It may require specifying regional endpoints when creating the service
#   client as shown in:
#   https://googleapis.dev/python/google-api-core/latest/client_options.html
from google.apps import meet_v2


async def sample_list_recordings():
    # Create a client
    client = meet_v2.ConferenceRecordsServiceAsyncClient()

    # Initialize request argument(s)
    request = meet_v2.ListRecordingsRequest(
        parent="parent_value",
    )

    # Make the request
    page_result = client.list_recordings(request=request)

    # Handle the response
    async for response in page_result:
        print(response)

cURL

curl -X GET \
  "https://meet.googleapis.com/v2/conferenceRecords/PARENT_NAME/recordings" \
  -H "Authorization: Bearer ACCESS_TOKEN"

Sostituisci ACCESS_TOKEN con il token di accesso che concede l'accesso all'API.

Sostituisci il nome del genitore con il nome dell'ID conferenza specifico in un record di conferenza.

Trascrizioni

Le sezioni seguenti descrivono in dettaglio come ottenere informazioni sulle trascrizioni delle conferenze in un record di conferenza.

Meet ha accesso all'ID della trascrizione una volta generati i dati della trascrizione. È possibile che un utente elimini il file della trascrizione da Drive, ma il nome univoco viene comunque restituito in Meet.

La risorsa transcripts include gli oggetti DocsDestination e State.

L'oggetto DocsDestination contiene la posizione di esportazione in Drive in cui viene salvato il file di trascrizione di Documenti Google. Per recuperare i contenuti o sfogliare la trascrizione in un browser, utilizza il valore del campo exportUri dell'oggetto. Se hai familiarità con l'API Google Docs, il valore del campo document corrisponde a documentId nella risorsa documents.

L'oggetto State contiene lo stato della sessione di trascrizione. In questo modo puoi chiedere se la sessione di trascrizione è iniziata, se è terminata ma il file di trascrizione non è pronto oppure se è stato generato e può essere scaricato.

Visualizzare i dettagli di una trascrizione

Per ottenere i dettagli di una trascrizione specifica, utilizza il metodo get sulla risorsa transcripts. Imposta il parametro di percorso name utilizzando il formato conferenceRecords/{conferenceRecord}/transcripts/{transcriptName}.

Se non conosci il nome della trascrizione, puoi elencare tutti i nomi delle trascrizioni utilizzando il metodo list.

Il metodo restituisce un'istanza di una risorsa transcripts.

Il seguente esempio di codice mostra come recuperare una trascrizione specifica:

Java

java-meet/samples/snippets/generated/com/google/apps/meet/v2/conferencerecordsservice/gettranscript/AsyncGetTranscript.java
import com.google.api.core.ApiFuture;
import com.google.apps.meet.v2.ConferenceRecordsServiceClient;
import com.google.apps.meet.v2.GetTranscriptRequest;
import com.google.apps.meet.v2.Transcript;
import com.google.apps.meet.v2.TranscriptName;

public class AsyncGetTranscript {

  public static void main(String[] args) throws Exception {
    asyncGetTranscript();
  }

  public static void asyncGetTranscript() throws Exception {
    // This snippet has been automatically generated and should be regarded as a code template only.
    // It will require modifications to work:
    // - It may require correct/in-range values for request initialization.
    // - It may require specifying regional endpoints when creating the service client as shown in
    // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
    try (ConferenceRecordsServiceClient conferenceRecordsServiceClient =
        ConferenceRecordsServiceClient.create()) {
      GetTranscriptRequest request =
          GetTranscriptRequest.newBuilder()
              .setName(TranscriptName.of("[CONFERENCE_RECORD]", "[TRANSCRIPT]").toString())
              .build();
      ApiFuture<Transcript> future =
          conferenceRecordsServiceClient.getTranscriptCallable().futureCall(request);
      // Do something.
      Transcript response = future.get();
    }
  }
}

Node.js

packages/google-apps-meet/samples/generated/v2/conference_records_service.get_transcript.js
/**
 * This snippet has been automatically generated and should be regarded as a code template only.
 * It will require modifications to work.
 * It may require correct/in-range values for request initialization.
 * TODO(developer): Uncomment these variables before running the sample.
 */
/**
 *  Required. Resource name of the transcript.
 */
// const name = 'abc123'

// Imports the Meet library
const {ConferenceRecordsServiceClient} = require('@google-apps/meet').v2;

// Instantiates a client
const meetClient = new ConferenceRecordsServiceClient();

async function callGetTranscript() {
  // Construct request
  const request = {
    name,
  };

  // Run request
  const response = await meetClient.getTranscript(request);
  console.log(response);
}

callGetTranscript();

Python

packages/google-apps-meet/samples/generated_samples/meet_v2_generated_conference_records_service_get_transcript_async.py
# This snippet has been automatically generated and should be regarded as a
# code template only.
# It will require modifications to work:
# - It may require correct/in-range values for request initialization.
# - It may require specifying regional endpoints when creating the service
#   client as shown in:
#   https://googleapis.dev/python/google-api-core/latest/client_options.html
from google.apps import meet_v2


async def sample_get_transcript():
    # Create a client
    client = meet_v2.ConferenceRecordsServiceAsyncClient()

    # Initialize request argument(s)
    request = meet_v2.GetTranscriptRequest(
        name="name_value",
    )

    # Make the request
    response = await client.get_transcript(request=request)

    # Handle the response
    print(response)

cURL

curl -X GET \
  "https://meet.googleapis.com/v2/conferenceRecords/CONFERENCE_RECORD_NAME/transcripts/TRANSCRIPT_NAME" \
  -H "Authorization: Bearer ACCESS_TOKEN"

Sostituisci ACCESS_TOKEN con il token di accesso che concede l'accesso all'API.

Sostituisci quanto segue:

  • Il nome del record della conferenza con il nome dell'ID conferenza specifico in un record della conferenza.
  • Il nome della trascrizione con il nome dell'ID trascrizione specifico in un record della conferenza.

Elenco di tutte le trascrizioni

Per elencare i dettagli di tutte le trascrizioni in un record di conferenza, utilizza il metodo list nella risorsa transcripts. Imposta il parametro di percorso parent utilizzando il formato conferenceRecords/{conferenceRecord}.

Il metodo restituisce un elenco di trascrizioni della conferenza, ordinate per startTime in ordine crescente, come istanza di una risorsa transcripts. Per regolare le dimensioni della pagina, vedi Personalizzare la paginazione.

Il seguente esempio di codice mostra come elencare tutte le trascrizioni in un record di conferenza:

Java

java-meet/samples/snippets/generated/com/google/apps/meet/v2/conferencerecordsservice/listtranscripts/AsyncListTranscripts.java
import com.google.api.core.ApiFuture;
import com.google.apps.meet.v2.ConferenceRecordName;
import com.google.apps.meet.v2.ConferenceRecordsServiceClient;
import com.google.apps.meet.v2.ListTranscriptsRequest;
import com.google.apps.meet.v2.Transcript;

public class AsyncListTranscripts {

  public static void main(String[] args) throws Exception {
    asyncListTranscripts();
  }

  public static void asyncListTranscripts() throws Exception {
    // This snippet has been automatically generated and should be regarded as a code template only.
    // It will require modifications to work:
    // - It may require correct/in-range values for request initialization.
    // - It may require specifying regional endpoints when creating the service client as shown in
    // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
    try (ConferenceRecordsServiceClient conferenceRecordsServiceClient =
        ConferenceRecordsServiceClient.create()) {
      ListTranscriptsRequest request =
          ListTranscriptsRequest.newBuilder()
              .setParent(ConferenceRecordName.of("[CONFERENCE_RECORD]").toString())
              .setPageSize(883849137)
              .setPageToken("pageToken873572522")
              .build();
      ApiFuture<Transcript> future =
          conferenceRecordsServiceClient.listTranscriptsPagedCallable().futureCall(request);
      // Do something.
      for (Transcript element : future.get().iterateAll()) {
        // doThingsWith(element);
      }
    }
  }
}

Node.js

packages/google-apps-meet/samples/generated/v2/conference_records_service.list_transcripts.js
/**
 * This snippet has been automatically generated and should be regarded as a code template only.
 * It will require modifications to work.
 * It may require correct/in-range values for request initialization.
 * TODO(developer): Uncomment these variables before running the sample.
 */
/**
 *  Required. Format: `conferenceRecords/{conference_record}`
 */
// const parent = 'abc123'
/**
 *  Maximum number of transcripts to return. The service might return fewer
 *  than this value.
 *  If unspecified, at most 10 transcripts are returned.
 *  The maximum value is 100; values above 100 are coerced to 100.
 *  Maximum might change in the future.
 */
// const pageSize = 1234
/**
 *  Page token returned from previous List Call.
 */
// const pageToken = 'abc123'

// Imports the Meet library
const {ConferenceRecordsServiceClient} = require('@google-apps/meet').v2;

// Instantiates a client
const meetClient = new ConferenceRecordsServiceClient();

async function callListTranscripts() {
  // Construct request
  const request = {
    parent,
  };

  // Run request
  const iterable = meetClient.listTranscriptsAsync(request);
  for await (const response of iterable) {
      console.log(response);
  }
}

callListTranscripts();

Python

packages/google-apps-meet/samples/generated_samples/meet_v2_generated_conference_records_service_list_transcripts_async.py
# This snippet has been automatically generated and should be regarded as a
# code template only.
# It will require modifications to work:
# - It may require correct/in-range values for request initialization.
# - It may require specifying regional endpoints when creating the service
#   client as shown in:
#   https://googleapis.dev/python/google-api-core/latest/client_options.html
from google.apps import meet_v2


async def sample_list_transcripts():
    # Create a client
    client = meet_v2.ConferenceRecordsServiceAsyncClient()

    # Initialize request argument(s)
    request = meet_v2.ListTranscriptsRequest(
        parent="parent_value",
    )

    # Make the request
    page_result = client.list_transcripts(request=request)

    # Handle the response
    async for response in page_result:
        print(response)

cURL

curl -X GET \
  "https://meet.googleapis.com/v2/conferenceRecords/PARENT_NAME/transcripts" \
  -H "Authorization: Bearer ACCESS_TOKEN"

Sostituisci ACCESS_TOKEN con il token di accesso che concede l'accesso all'API.

Sostituisci il nome del genitore con il nome dell'ID conferenza specifico in un record di conferenza.

Voci della trascrizione

Le sezioni seguenti descrivono in dettaglio come ottenere il discorso di ogni partecipante come voci della trascrizione durante una sessione di trascrizione della conferenza.

La voce della trascrizione contiene il testo trascritto della voce del partecipante, fino a un massimo di 10.000 parole. Il testo parlato languageCode (ad esempio, en-US) è incluso anche come sintassi IETF BCP 47.

Ogni voce della trascrizione è collegata a un nome participant nella conferenza. Per recuperare i dettagli di un partecipante, vedi Visualizzare i dettagli di un partecipante.

I dati delle voci della trascrizione sono disponibili per 30 giorni dopo la fine della conferenza.

Tieni presente che le voci della trascrizione restituite dall'API REST di Meet potrebbero non corrispondere alla trascrizione trovata nel file di trascrizione di Documenti. Ciò si verifica quando il file di trascrizione viene modificato dopo la generazione.

Visualizzare i dettagli di una voce della trascrizione

Per ottenere i dettagli di una voce di trascrizione specifica, utilizza il metodo get nella risorsa transcripts.entries. Imposta il parametro di percorso name utilizzando il formato conferenceRecords/{conferenceRecord}/transcripts/{transcriptName}/entries/{transcriptEntryName}.

Se non conosci il nome della voce della trascrizione, puoi elencare tutti i nomi delle voci della trascrizione utilizzando il metodo list.

Il metodo restituisce un'istanza di una risorsa transcripts.entries.

Il seguente esempio di codice mostra come recuperare una voce di trascrizione specifica:

Java

java-meet/samples/snippets/generated/com/google/apps/meet/v2/conferencerecordsservice/gettranscriptentry/AsyncGetTranscriptEntry.java
import com.google.api.core.ApiFuture;
import com.google.apps.meet.v2.ConferenceRecordsServiceClient;
import com.google.apps.meet.v2.GetTranscriptEntryRequest;
import com.google.apps.meet.v2.TranscriptEntry;
import com.google.apps.meet.v2.TranscriptEntryName;

public class AsyncGetTranscriptEntry {

  public static void main(String[] args) throws Exception {
    asyncGetTranscriptEntry();
  }

  public static void asyncGetTranscriptEntry() throws Exception {
    // This snippet has been automatically generated and should be regarded as a code template only.
    // It will require modifications to work:
    // - It may require correct/in-range values for request initialization.
    // - It may require specifying regional endpoints when creating the service client as shown in
    // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
    try (ConferenceRecordsServiceClient conferenceRecordsServiceClient =
        ConferenceRecordsServiceClient.create()) {
      GetTranscriptEntryRequest request =
          GetTranscriptEntryRequest.newBuilder()
              .setName(
                  TranscriptEntryName.of("[CONFERENCE_RECORD]", "[TRANSCRIPT]", "[ENTRY]")
                      .toString())
              .build();
      ApiFuture<TranscriptEntry> future =
          conferenceRecordsServiceClient.getTranscriptEntryCallable().futureCall(request);
      // Do something.
      TranscriptEntry response = future.get();
    }
  }
}

Node.js

packages/google-apps-meet/samples/generated/v2/conference_records_service.get_transcript_entry.js
/**
 * This snippet has been automatically generated and should be regarded as a code template only.
 * It will require modifications to work.
 * It may require correct/in-range values for request initialization.
 * TODO(developer): Uncomment these variables before running the sample.
 */
/**
 *  Required. Resource name of the `TranscriptEntry`.
 */
// const name = 'abc123'

// Imports the Meet library
const {ConferenceRecordsServiceClient} = require('@google-apps/meet').v2;

// Instantiates a client
const meetClient = new ConferenceRecordsServiceClient();

async function callGetTranscriptEntry() {
  // Construct request
  const request = {
    name,
  };

  // Run request
  const response = await meetClient.getTranscriptEntry(request);
  console.log(response);
}

callGetTranscriptEntry();

Python

packages/google-apps-meet/samples/generated_samples/meet_v2_generated_conference_records_service_get_transcript_entry_async.py
# This snippet has been automatically generated and should be regarded as a
# code template only.
# It will require modifications to work:
# - It may require correct/in-range values for request initialization.
# - It may require specifying regional endpoints when creating the service
#   client as shown in:
#   https://googleapis.dev/python/google-api-core/latest/client_options.html
from google.apps import meet_v2


async def sample_get_transcript_entry():
    # Create a client
    client = meet_v2.ConferenceRecordsServiceAsyncClient()

    # Initialize request argument(s)
    request = meet_v2.GetTranscriptEntryRequest(
        name="name_value",
    )

    # Make the request
    response = await client.get_transcript_entry(request=request)

    # Handle the response
    print(response)

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"

Sostituisci ACCESS_TOKEN con il token di accesso che concede l'accesso all'API.

Sostituisci quanto segue:

  • Il nome del record della conferenza con il nome dell'ID conferenza specifico in un record della conferenza.
  • Il nome della trascrizione con il nome dell'ID trascrizione specifico in un record della conferenza.
  • Il nome della voce della trascrizione con il nome dell'ID voce della trascrizione specifico in una trascrizione.

Elenco di tutte le voci della trascrizione

Per elencare i dettagli di tutte le voci della trascrizione, utilizza il metodo list nella risorsa transcripts.entries. Imposta il parametro di percorso parent utilizzando il formato conferenceRecords/{conferenceRecord}/transcripts/{transcript}.

Il metodo restituisce un elenco di voci di trascrizione strutturate per ogni trascrizione della conferenza, ordinate in base a startTime in ordine crescente, come istanza di una risorsa transcripts.entries. Per regolare le dimensioni della pagina, vedi Personalizzare la paginazione.

Il seguente esempio di codice mostra come elencare tutte le voci della trascrizione in una trascrizione:

Java

java-meet/samples/snippets/generated/com/google/apps/meet/v2/conferencerecordsservice/listtranscriptentries/AsyncListTranscriptEntries.java
import com.google.api.core.ApiFuture;
import com.google.apps.meet.v2.ConferenceRecordsServiceClient;
import com.google.apps.meet.v2.ListTranscriptEntriesRequest;
import com.google.apps.meet.v2.TranscriptEntry;
import com.google.apps.meet.v2.TranscriptName;

public class AsyncListTranscriptEntries {

  public static void main(String[] args) throws Exception {
    asyncListTranscriptEntries();
  }

  public static void asyncListTranscriptEntries() throws Exception {
    // This snippet has been automatically generated and should be regarded as a code template only.
    // It will require modifications to work:
    // - It may require correct/in-range values for request initialization.
    // - It may require specifying regional endpoints when creating the service client as shown in
    // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
    try (ConferenceRecordsServiceClient conferenceRecordsServiceClient =
        ConferenceRecordsServiceClient.create()) {
      ListTranscriptEntriesRequest request =
          ListTranscriptEntriesRequest.newBuilder()
              .setParent(TranscriptName.of("[CONFERENCE_RECORD]", "[TRANSCRIPT]").toString())
              .setPageSize(883849137)
              .setPageToken("pageToken873572522")
              .build();
      ApiFuture<TranscriptEntry> future =
          conferenceRecordsServiceClient.listTranscriptEntriesPagedCallable().futureCall(request);
      // Do something.
      for (TranscriptEntry element : future.get().iterateAll()) {
        // doThingsWith(element);
      }
    }
  }
}

Node.js

packages/google-apps-meet/samples/generated/v2/conference_records_service.list_transcript_entries.js
/**
 * This snippet has been automatically generated and should be regarded as a code template only.
 * It will require modifications to work.
 * It may require correct/in-range values for request initialization.
 * TODO(developer): Uncomment these variables before running the sample.
 */
/**
 *  Required. Format:
 *  `conferenceRecords/{conference_record}/transcripts/{transcript}`
 */
// const parent = 'abc123'
/**
 *  Maximum number of entries to return. The service might return fewer than
 *  this value.
 *  If unspecified, at most 10 entries are returned.
 *  The maximum value is 100; values above 100 are coerced to 100.
 *  Maximum might change in the future.
 */
// const pageSize = 1234
/**
 *  Page token returned from previous List Call.
 */
// const pageToken = 'abc123'

// Imports the Meet library
const {ConferenceRecordsServiceClient} = require('@google-apps/meet').v2;

// Instantiates a client
const meetClient = new ConferenceRecordsServiceClient();

async function callListTranscriptEntries() {
  // Construct request
  const request = {
    parent,
  };

  // Run request
  const iterable = meetClient.listTranscriptEntriesAsync(request);
  for await (const response of iterable) {
      console.log(response);
  }
}

callListTranscriptEntries();

Python

packages/google-apps-meet/samples/generated_samples/meet_v2_generated_conference_records_service_list_transcript_entries_async.py
# This snippet has been automatically generated and should be regarded as a
# code template only.
# It will require modifications to work:
# - It may require correct/in-range values for request initialization.
# - It may require specifying regional endpoints when creating the service
#   client as shown in:
#   https://googleapis.dev/python/google-api-core/latest/client_options.html
from google.apps import meet_v2


async def sample_list_transcript_entries():
    # Create a client
    client = meet_v2.ConferenceRecordsServiceAsyncClient()

    # Initialize request argument(s)
    request = meet_v2.ListTranscriptEntriesRequest(
        parent="parent_value",
    )

    # Make the request
    page_result = client.list_transcript_entries(request=request)

    # Handle the response
    async for response in page_result:
        print(response)

cURL

curl -X GET \
  "https://meet.googleapis.com/v2/conferenceRecords/CONFERENCE_RECORD_NAME/transcripts/TRANSCRIPT_NAME/entries" \
  -H "Authorization: Bearer ACCESS_TOKEN"

Sostituisci ACCESS_TOKEN con il token di accesso che concede l'accesso all'API.

Sostituisci quanto segue:

  • Il nome del record della conferenza con il nome dell'ID conferenza specifico in un record della conferenza.
  • Il nome della trascrizione con il nome dell'ID trascrizione specifico in un record della conferenza.

Appunti intelligenti

Le sezioni seguenti descrivono in dettaglio come ottenere informazioni sugli appunti intelligenti in un record della conferenza.

Meet ha accesso all'ID della nota intelligente una volta generati i dati della nota intelligente. È possibile che un utente elimini il file delle note intelligenti da Drive, ma il nome univoco viene comunque restituito in Meet.

La risorsa smartNotes include l'oggetto State. Questo oggetto contiene lo stato della sessione di appunti intelligenti. In questo modo puoi chiedere se la sessione di appunti intelligenti è iniziata, se è terminata ma il file di appunti intelligenti non è pronto o se è stato generato ed è pronto per il download.

La risorsa smartNotes include anche il tipo di oggetto DocsDestination. Questo oggetto contiene la posizione di esportazione in Drive in cui viene salvato il file delle note intelligenti di Google Docs. Per recuperare i contenuti o sfogliare le note intelligenti in un browser, utilizza il valore del campo exportUri dell'oggetto. Se hai familiarità con l'API Google Docs, il valore del campo document corrisponde a documentId nella risorsa documents.

Puoi gestire le note intelligenti utilizzando i metodi get e list.

Visualizzare i dettagli sugli appunti intelligenti

Per ottenere dettagli su un file di note intelligenti specifico, utilizza il metodo get sulla risorsa smartNotes. Imposta il parametro di percorso name utilizzando il formato conferenceRecords/{conferenceRecord}/smartNotes/{smartNote}.

Se non conosci il nome della nota intelligente, puoi elencare tutti i file delle note intelligenti utilizzando il metodo list.

Il metodo restituisce un'istanza di una risorsa smartNotes.

Il seguente esempio di codice mostra come recuperare un file di appunti intelligenti specifico:

Java

import com.google.apps.meet.v2.ConferenceRecordsServiceClient;
import com.google.apps.meet.v2.SmartNote;

public class GetSmartNote {
  public static void main(String[] args) throws Exception {
    try (ConferenceRecordsServiceClient client =
        ConferenceRecordsServiceClient.create()) {
      SmartNote response = client.getSmartNote(
          "conferenceRecords/CONFERENCE_RECORD_NAME/smartNotes/SMART_NOTES_NAME");
      System.out.println("Smart note name: " + response.getName());
    }
  }
}

Node.js

const {ConferenceRecordsServiceClient} = require('@google-apps/meet').v2;

async function getSmartNote(smartNoteName) {
  const client = new ConferenceRecordsServiceClient();
  const [response] = await client.getSmartNote({name: smartNoteName});
  console.log(`Smart note name: ${response.name}`);
  return response;
}

Python

from google.apps import meet_v2

def get_smart_note(smart_note_name):
    client = meet_v2.ConferenceRecordsServiceClient()
    response = client.get_smart_note(name=smart_note_name)
    print(f"Smart note name: {response.name}")
    return response

cURL

curl -X GET \
  "https://meet.googleapis.com/v2/conferenceRecords/CONFERENCE_RECORD_NAME/smartNotes/SMART_NOTES_NAME" \
  -H "Authorization: Bearer ACCESS_TOKEN"

Sostituisci ACCESS_TOKEN con il token di accesso che concede l'accesso all'API.

Sostituisci quanto segue:

  • Il nome del record della conferenza con il nome dell'ID conferenza specifico in un record della conferenza.
  • Il nome della nota intelligente con il nome dell'ID nota intelligente specifico in un record della conferenza.

Elenco di tutti gli appunti intelligenti

Per elencare i dettagli di tutti i file di note intelligenti in un record della conferenza, utilizza il metodo list sulla risorsa smartNotes. Imposta il parametro di percorso parent utilizzando il formato conferenceRecords/{conferenceRecord}.

Il metodo restituisce un elenco di file di appunti intelligenti della conferenza, ordinati per startTime in ordine crescente, come istanza di una risorsa smartNotes. Per regolare le dimensioni della pagina, consulta Personalizzare la paginazione.

Il seguente esempio di codice mostra come elencare tutti i file di note intelligenti in un record di conferenza:

Java

import com.google.apps.meet.v2.ConferenceRecordsServiceClient;
import com.google.apps.meet.v2.SmartNote;

public class ListSmartNotes {
  public static void main(String[] args) throws Exception {
    try (ConferenceRecordsServiceClient client =
        ConferenceRecordsServiceClient.create()) {
      for (SmartNote smartNote : client
          .listSmartNotes("conferenceRecords/CONFERENCE_RECORD_NAME")
          .iterateAll()) {
        System.out.println("Smart note name: " + smartNote.getName());
      }
    }
  }
}

Node.js

const {ConferenceRecordsServiceClient} = require('@google-apps/meet').v2;

async function listSmartNotes(conferenceRecordName) {
  const client = new ConferenceRecordsServiceClient();
  const [smartNotes] =
      await client.listSmartNotes({parent: conferenceRecordName});
  smartNotes.forEach((smartNote) => {
    console.log(`Smart note name: ${smartNote.name}`);
  });
  return smartNotes;
}

Python

from google.apps import meet_v2

def list_smart_notes(conference_record_name):
    client = meet_v2.ConferenceRecordsServiceClient()
    response = client.list_smart_notes(parent=conference_record_name)
    for smart_note in response:
        print(f"Smart note name: {smart_note.name}")

cURL

curl -X GET \
  "https://meet.googleapis.com/v2/conferenceRecords/PARENT_NAME/smartNotes" \
  -H "Authorization: Bearer ACCESS_TOKEN"

Sostituisci ACCESS_TOKEN con il token di accesso che concede l'accesso all'API.

Sostituisci il nome del genitore con il nome dell'ID conferenza specifico in un record di conferenza.

Personalizzare la paginazione

Passa i seguenti parametri di query per personalizzare la paginazione di registrazioni, trascrizioni, voci di trascrizione e appunti intelligenti:

  • pageSize: il numero massimo di elementi da restituire. Il servizio potrebbe restituire un numero inferiore a questo valore. Se non specificato, vengono restituiti al massimo 10 elementi. Il valore massimo è 100; i valori superiori a 100 vengono automaticamente modificati in 100.

  • pageToken: un token di pagina ricevuto da una precedente chiamata dell'elenco. Fornisci questo token per recuperare la pagina successiva.