Organizza conferenze

Questa guida spiega come ottenere i dettagli di una singola conferenza o di tutte le conferenze nella risorsa conferenceRecords dell'API REST di Google Meet.

Una conferenza è un'istanza di chiamata generata dal server all'interno di uno spazio di riunione. È anche un'unica istanza di riunione.

Se sei il proprietario o un partecipante di uno spazio di riunione, puoi chiamare i metodi get() e list() per recuperare i record della conferenza.

L'autenticazione e l'autorizzazione con le credenziali dell'utente consentono alle app Google Meet di accedere ai dati dell'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 che sia necessario il consenso di ogni utente.

Visualizzare i dettagli di una conferenza

Per visualizzare i dettagli di una conferenza specifica, utilizza il metodo get() nella risorsa conferenceRecords con il parametro di percorso name della conferenza. Se non conosci il nome della conferenza, puoi elencare tutti i nomi delle conferenze utilizzando il metodo list().

Il metodo restituisce una conferenza passata come istanza della risorsa conferenceRecords.

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

Java

java-meet/samples/snippets/generated/com/google/apps/meet/v2/conferencerecordsservice/getconferencerecord/AsyncGetConferenceRecord.java
import com.google.api.core.ApiFuture;
import com.google.apps.meet.v2.ConferenceRecord;
import com.google.apps.meet.v2.ConferenceRecordName;
import com.google.apps.meet.v2.ConferenceRecordsServiceClient;
import com.google.apps.meet.v2.GetConferenceRecordRequest;

public class AsyncGetConferenceRecord {

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

  public static void asyncGetConferenceRecord() 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()) {
      GetConferenceRecordRequest request =
          GetConferenceRecordRequest.newBuilder()
              .setName(ConferenceRecordName.of("[CONFERENCE_RECORD]").toString())
              .build();
      ApiFuture<ConferenceRecord> future =
          conferenceRecordsServiceClient.getConferenceRecordCallable().futureCall(request);
      // Do something.
      ConferenceRecord response = future.get();
    }
  }
}

Node.js

packages/google-apps-meet/samples/generated/v2/conference_records_service.get_conference_record.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 conference.
 */
// const name = 'abc123'

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

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

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

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

callGetConferenceRecord();

Python

packages/google-apps-meet/samples/generated_samples/meet_v2_generated_conference_records_service_get_conference_record_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_conference_record():
    # Create a client
    client = meet_v2.ConferenceRecordsServiceAsyncClient()

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

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

    # Handle the response
    print(response)

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

Elenca tutte le conferenze

Per elencare i dettagli di tutte le conferenze, utilizza il metodo list() nella risorsa conferenceRecords senza parametri di percorso.

Il metodo restituisce un elenco di conferenze passate come istanza della risorsa conferenceRecords. Vengono filtrati in base all'organizzatore della conferenza e ordinati per startTime in ordine decrescente. Per regolare le dimensioni della pagina e filtrare i risultati della query, consulta Personalizzare la paginazione o filtrare l'elenco.

Il seguente esempio di codice mostra come elencare tutte le conferenze:

Java

java-meet/samples/snippets/generated/com/google/apps/meet/v2/conferencerecordsservice/listconferencerecords/AsyncListConferenceRecords.java
import com.google.api.core.ApiFuture;
import com.google.apps.meet.v2.ConferenceRecord;
import com.google.apps.meet.v2.ConferenceRecordsServiceClient;
import com.google.apps.meet.v2.ListConferenceRecordsRequest;

public class AsyncListConferenceRecords {

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

  public static void asyncListConferenceRecords() 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()) {
      ListConferenceRecordsRequest request =
          ListConferenceRecordsRequest.newBuilder()
              .setPageSize(883849137)
              .setPageToken("pageToken873572522")
              .setFilter("filter-1274492040")
              .build();
      ApiFuture<ConferenceRecord> future =
          conferenceRecordsServiceClient.listConferenceRecordsPagedCallable().futureCall(request);
      // Do something.
      for (ConferenceRecord element : future.get().iterateAll()) {
        // doThingsWith(element);
      }
    }
  }
}

Node.js

packages/google-apps-meet/samples/generated/v2/conference_records_service.list_conference_records.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.
 */
/**
 *  Optional. Maximum number of conference records to return. The service might
 *  return fewer than this value. If unspecified, at most 25 conference records
 *  are returned. The maximum value is 100; values above 100 are coerced to
 *  100. Maximum might change in the future.
 */
// const pageSize = 1234
/**
 *  Optional. Page token returned from previous List Call.
 */
// const pageToken = 'abc123'
/**
 *  Optional. User specified filtering condition in EBNF
 *  format (https://en.wikipedia.org/wiki/Extended_Backus%E2%80%93Naur_form).
 *  The following are the filterable fields:
 *  * `space.meeting_code`
 *  * `space.name`
 *  * `start_time`
 *  * `end_time`
 *  For example, consider the following filters:
 *  * `space.name = "spaces/NAME"`
 *  * `space.meeting_code = "abc-mnop-xyz"`
 *  * `start_time>="2024-01-01T00:00:00.000Z" AND
 *  start_time<="2024-01-02T00:00:00.000Z"`
 *  * `end_time IS NULL`
 */
// const filter = 'abc123'

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

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

async function callListConferenceRecords() {
  // Construct request
  const request = {
  };

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

callListConferenceRecords();

Python

packages/google-apps-meet/samples/generated_samples/meet_v2_generated_conference_records_service_list_conference_records_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_conference_records():
    # Create a client
    client = meet_v2.ConferenceRecordsServiceAsyncClient()

    # Initialize request argument(s)
    request = meet_v2.ListConferenceRecordsRequest(
    )

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

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

Personalizzare la paginazione o filtrare l'elenco

Passa i seguenti parametri di query facoltativi per personalizzare la paginazione o filtrare i record delle conferenze:

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

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

  • filter: un filtro di query per recuperare elementi specifici nei risultati della risorsaconferenceRecords. Per i dettagli delle query supportate, consulta il metodo list(). Per maggiori informazioni su come determinare uno spazio per le riunioni, vedi In che modo Meet identifica uno spazio per le riunioni.