Trabalhar com conferências

Neste guia, explicamos como receber detalhes sobre uma única conferência ou todas as conferências no recurso conferenceRecords da API REST do Google Meet.

Uma conferência é uma instância de uma chamada gerada pelo servidor em um espaço de reunião. Ela também é uma única instância de uma reunião.

Se você for proprietário ou participante de um espaço de reunião, poderá chamar os métodos get() e list() para recuperar os registros de conferências.

A autenticação e a autorização com credenciais de usuário permitem que os apps do Google Meet acessem dados do usuário e realizem operações em nome do usuário autenticado. A autenticação com delegação em todo o domínio permite autorizar a conta de serviço de um aplicativo a acessar os dados dos usuários sem precisar pedir o consentimento de cada um deles.

Receber detalhes sobre uma conferência

Para ver detalhes sobre uma conferência específica, use o método get() no recurso conferenceRecords com o parâmetro de caminho name da conferência. Se você não souber o nome da conferência, liste todos os nomes de conferências usando o método list().

O método retorna uma conferência passada como uma instância do recurso conferenceRecords.

O exemplo de código a seguir mostra como recuperar uma conferência específica:

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)

Substitua o nome do registro da conferência pelo ID específico em um registro de conferência.

Listar todas as conferências

Para listar detalhes sobre todas as conferências, use o método list() no recurso conferenceRecords sem parâmetros de caminho.

O método retorna uma lista de conferências anteriores como uma instância do recurso conferenceRecords. Eles são filtrados para o organizador da conferência e ordenados por startTime em ordem decrescente. Para ajustar o tamanho da página e filtrar os resultados da consulta, consulte Personalizar a paginação ou filtrar a lista.

O exemplo de código a seguir mostra como listar todas as conferências:

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)

Personalizar a paginação ou filtrar a lista

Transmita os seguintes parâmetros de consulta opcionais para personalizar a paginação ou filtrar registros de conferências:

  • pageSize: o número máximo de registros de conferência a serem retornados. O serviço pode retornar menos que esse valor. Se não for especificado, no máximo 25 registros de conferência serão retornados. O valor máximo é 100. Valores maiores que 100 são automaticamente alterados para 100.

  • pageToken: um token de página recebido de uma chamada de lista anterior. Informe esse token para recuperar a página subsequente.

  • filter: um filtro de consulta para recuperar itens específicos nos resultados do recurso conferenceRecords. Para detalhes sobre consultas compatíveis, consulte o método list(). Para mais informações sobre como determinar um espaço de reunião, consulte Como o Meet identifica um espaço de reunião.