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 una chiamata generata dal server all'interno di uno spazio per le riunioni. È anche una singola istanza di una riunione.

Se sei il proprietario o un partecipante di uno spazio per le riunioni, puoi chiamare i metodi get e list per recuperare i record delle conferenze.

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

Ottenere i dettagli di una conferenza

Per ottenere i dettagli di una conferenza specifica, utilizza il get metodo su la conferenceRecords risorsa. Imposta il parametro del percorso name della conferenza utilizzando il formato conferenceRecords/{conferenceRecord}.

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

Visualizza su GitHub

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

Visualizza su GitHub

/**
 * 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

Visualizza su GitHub

# 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)

cURL

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

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

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

Elencare tutte le conferenze

Per elencare i dettagli di tutte le conferenze, utilizza il list metodo su la conferenceRecords risorsa senza parametri di percorso.

Il metodo restituisce un elenco di conferenze passate come istanza della risorsa conferenceRecords. Vengono filtrate in base all'organizzatore della conferenza e ordinate 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.

Nota: il metodo list restituisce solo le conferenze di cui sei l'organizzatore della riunione. Se l'app che utilizzi per visualizzare le conferenze ha solo l'ambito OAuth meetings.space.created, puoi visualizzare solo le conferenze per gli spazi creati dall'app. Per ulteriori informazioni, consulta Ambiti dell'API REST di Meet.

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

Visualizza su GitHub

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

Visualizza su GitHub

/**
 * 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

Visualizza su GitHub

# 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)

cURL

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

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

Personalizzare la paginazione o filtrare l'elenco

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

• pageSize: il numero massimo di record delle conferenze da restituire. Il servizio potrebbe restituire un valore inferiore. 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 risorsa conferenceRecords. Per i dettagli delle query supportate, consulta il list metodo. Per ulteriori informazioni su come determinare uno spazio per le riunioni, consulta In che modo Meet identifica uno spazio per le riunioni.