Работа с конференциями

В этом руководстве объясняется, как получить сведения об одной конференции или обо всех конференциях в ресурсе conferenceRecords API Google Meet REST.

Конференция — это сгенерированный сервером экземпляр звонка в рамках конференц-зала. Это также отдельный экземпляр конференции.

Если вы являетесь владельцем или участником конференц-зала, вы можете вызвать методы get() и list() для получения записей конференции.

Аутентификация и авторизация с использованием учётных данных пользователя позволяют приложениям Google Meet получать доступ к данным пользователя и выполнять операции от его имени. Аутентификация с делегированием на уровне домена позволяет предоставить сервисной учётной записи приложения доступ к данным ваших пользователей, не требуя согласия каждого пользователя.

Получить подробную информацию о конференции

Чтобы получить информацию о конкретной конференции, используйте метод get() ресурса conferenceRecords с параметром path, указывающим name конференции. Если вы не знаете название конференции, вы можете получить список всех названий конференций с помощью метода list() .

Метод возвращает прошедшую конференцию как экземпляр ресурса conferenceRecords .

В следующем примере кода показано, как получить конкретную конференцию:

Ява

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

Посмотреть на 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

Посмотреть на 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();

Питон

packages/google-apps-meet/samples/generated_samples/meet_v2_generated_conference_records_service_get_conference_record_async.py

Посмотреть на 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)

Замените имя записи конференции на имя конкретного идентификатора конференции в записи конференции.

Список всех конференций

Чтобы вывести список сведений обо всех конференциях, используйте метод list() ресурса conferenceRecords без каких-либо параметров пути.

Метод возвращает список прошедших конференций как экземпляр ресурса conferenceRecords . Они фильтруются по организатору конференции и сортируются по startTime в порядке убывания. Чтобы настроить размер страницы и отфильтровать результаты запроса, см . раздел Настройка пагинации или фильтрация списка .

Примечание: Метод list() возвращает только конференции, организатором которых вы являетесь. Если приложение, используемое для просмотра конференций, имеет только область действия OAuth meetings.space.created , вы сможете просматривать конференции только в пространствах, созданных этим приложением. Подробнее см. в разделе Области действия API REST Meet .

В следующем примере кода показано, как составить список всех конференций:

Ява

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

Посмотреть на 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

Посмотреть на 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();

Питон

packages/google-apps-meet/samples/generated_samples/meet_v2_generated_conference_records_service_list_conference_records_async.py

Посмотреть на 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)

Настройте пагинацию или отфильтруйте список

Передайте следующие необязательные параметры запроса для настройки пагинации или фильтрации записей конференций:

• pageSize : Максимальное количество возвращаемых записей конференций. Сервис может вернуть меньше этого значения. Если не указано, возвращается не более 25 записей конференций. Максимальное значение — 100; значения больше 100 автоматически изменяются на 100.

• pageToken : токен страницы, полученный при предыдущем вызове списка. Укажите этот токен для получения следующей страницы.

• filter : фильтр запроса для извлечения определённых элементов из результатов ресурса conferenceRecords . Подробную информацию о поддерживаемых запросах см. в описании метода list() . Подробнее об определении места встречи см. в статье «Как Meet определяет место встречи» .