Trabajar con conferencias

En esta guía, se explica cómo obtener detalles sobre una sola conferencia o todas las conferencias en el recurso conferenceRecords de la API de REST de Google Meet.

Una conferencia es una instancia de una llamada generada por el servidor dentro de un espacio de reunión. También es una sola instancia de una reunión.

Si eres propietario o participante de un espacio de reuniones, puedes llamar a los métodos get y list para recuperar los registros de conferencias.

La autenticación y autorización con credenciales de usuario permiten que las apps de Google Meet accedan a los datos del usuario y realicen operaciones en nombre del usuario autenticado. La autenticación con la delegación en todo el dominio te permite autorizar la cuenta de servicio de una aplicación para acceder a los datos de tus usuarios sin necesidad de que cada usuario dé su consentimiento.

Obtén detalles sobre una conferencia

Para obtener detalles sobre una conferencia específica, usa el método get en el recurso conferenceRecords. Configura el parámetro de ruta de acceso name de la conferencia con el formato conferenceRecords/{conferenceRecord}.

Si no conoces el nombre de la conferencia, puedes listar todos los nombres de las conferencias con el método list.

El método devuelve una conferencia pasada como una instancia del recurso conferenceRecords.

En la siguiente muestra de código, se muestra cómo recuperar una conferencia específica:

Java

java-meet/samples/snippets/generated/com/google/apps/meet/v2/conferencerecordsservice/getconferencerecord/AsyncGetConferenceRecord.java

Ver en 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

Ver en 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

Ver en 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"

Reemplaza ACCESS_TOKEN por el token de acceso que otorga acceso a la API.

Reemplaza el nombre del registro de la conferencia por el nombre del ID de conferencia específico en un registro de conferencia.

Enumera todas las conferencias

Para enumerar detalles sobre todas las conferencias, usa el método list en el recurso conferenceRecords sin ningún parámetro de ruta.

El método devuelve una lista de conferencias anteriores como una instancia del recurso conferenceRecords. Se filtran para el organizador de la conferencia y se ordenan por startTime en orden descendente. Para ajustar el tamaño de la página y filtrar los resultados de la búsqueda, consulta Cómo personalizar la paginación o filtrar la lista.

Nota: El método list solo devuelve las conferencias en las que eres el organizador de la reunión. Si la app que usas para ver conferencias solo tiene el alcance de OAuth meetings.space.created, solo podrás ver las conferencias de los espacios que creó la app. Para obtener más información, consulta Conoce los alcances de la API de REST de Meet.

En la siguiente muestra de código, se muestra cómo enumerar todas las conferencias:

Java

java-meet/samples/snippets/generated/com/google/apps/meet/v2/conferencerecordsservice/listconferencerecords/AsyncListConferenceRecords.java

Ver en 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

Ver en 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

Ver en 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"

Reemplaza ACCESS_TOKEN por el token de acceso que otorga acceso a la API.

Personaliza la paginación o filtra la lista

Pasa los siguientes parámetros de búsqueda opcionales para personalizar la paginación o filtrar los registros de conferencias:

• pageSize: Es la cantidad máxima de registros de conferencias que se devolverán. Es posible que el servicio devuelva menos que este valor. Si no se especifica, se devolverán, como máximo, 25 registros de conferencias. El valor máximo es 100, y los valores superiores a 100 se cambian automáticamente a 100.

• pageToken: Es un token de página que se recibió de una llamada a lista anterior. Proporciona este token para recuperar la página siguiente.

• filter: Es un filtro de consulta para recuperar elementos específicos en los resultados del recurso conferenceRecords. Para obtener detalles sobre las búsquedas admitidas, consulta el método list. Para obtener más información sobre cómo determinar un espacio de reunión, consulta Cómo identifica Meet un espacio de reunión.