Работа с участниками

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

Участник — это человек, присоединившийся к вызову или использующий режим Companion , наблюдающий за происходящим в качестве зрителя, или устройство в комнате, подключенное к вызову. Для каждого человека имеется один ресурс participants .

Сеанс участника — это уникальный идентификатор сеанса, созданный для каждой пары участник-устройство, которая присоединяется к вызову. Для каждого сеанса существует один ресурс participantSessions . Если участник присоединяется к одному и тому же вызову несколько раз с одной и той же пары участник-устройство, каждому из них присваиваются уникальные идентификаторы сеанса.

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

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

Участники

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

Ресурсы participants объединяются с user полем. user может быть только одним из следующих объектов:

  • signedinUser — это либо:

    • Человек, присоединяющийся с персонального компьютера, мобильного устройства или через режим Companion.

    • Учетная запись робота, используемая устройствами конференц-зала.

  • anonymousUser — это неопознанный пользователь, не вошедший в учетную запись Google.

  • phoneUser — это пользователь, звонящий с телефона, личность которого неизвестна, поскольку он не вошел в систему с помощью учетной записи Google.

Обратите внимание: хотя все три объекта возвращают displayName , signedinUser также возвращает уникальный идентификатор user , совместимый с API Admin SDK и People API. Формат: users/{user} . Дополнительные сведения об использовании идентификатора user с API People см. в разделе Получение сведений об участниках с помощью API People .

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

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

Метод возвращает данные участника как экземпляр ресурса participants .

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

Ява

java-meet/samples/snippets/generated/com/google/apps/meet/v2/conferencerecordsservice/getparticipant/AsyncGetParticipant.java
import com.google.api.core.ApiFuture;
import com.google.apps.meet.v2.ConferenceRecordsServiceClient;
import com.google.apps.meet.v2.GetParticipantRequest;
import com.google.apps.meet.v2.Participant;
import com.google.apps.meet.v2.ParticipantName;

public class AsyncGetParticipant {

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

  public static void asyncGetParticipant() 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()) {
      GetParticipantRequest request =
          GetParticipantRequest.newBuilder()
              .setName(ParticipantName.of("[CONFERENCE_RECORD]", "[PARTICIPANT]").toString())
              .build();
      ApiFuture<Participant> future =
          conferenceRecordsServiceClient.getParticipantCallable().futureCall(request);
      // Do something.
      Participant response = future.get();
    }
  }
}

Node.js

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

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

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

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

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

callGetParticipant();

Питон

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

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

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

    # Handle the response
    print(response)

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

Список всех участников

Чтобы просмотреть сведения обо всех участниках записи конференции, используйте метод list() ресурса participants с параметром parent пути. Формат: conferenceRecords/{conferenceRecord} .

Метод возвращает список участников конференции, упорядоченный по значению earliestStartTime в порядке убывания, как экземпляр ресурса participants . Чтобы настроить размер страницы и отфильтровать результаты запроса, см. раздел Настройка нумерации страниц или фильтрация списка участников .

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

Ява

java-meet/samples/snippets/generated/com/google/apps/meet/v2/conferencerecordsservice/listparticipants/AsyncListParticipants.java
import com.google.api.core.ApiFuture;
import com.google.apps.meet.v2.ConferenceRecordName;
import com.google.apps.meet.v2.ConferenceRecordsServiceClient;
import com.google.apps.meet.v2.ListParticipantsRequest;
import com.google.apps.meet.v2.Participant;

public class AsyncListParticipants {

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

  public static void asyncListParticipants() 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()) {
      ListParticipantsRequest request =
          ListParticipantsRequest.newBuilder()
              .setParent(ConferenceRecordName.of("[CONFERENCE_RECORD]").toString())
              .setPageSize(883849137)
              .setPageToken("pageToken873572522")
              .setFilter("filter-1274492040")
              .build();
      ApiFuture<Participant> future =
          conferenceRecordsServiceClient.listParticipantsPagedCallable().futureCall(request);
      // Do something.
      for (Participant element : future.get().iterateAll()) {
        // doThingsWith(element);
      }
    }
  }
}

Node.js

packages/google-apps-meet/samples/generated/v2/conference_records_service.list_participants.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. Format: `conferenceRecords/{conference_record}`
 */
// const parent = 'abc123'
/**
 *  Maximum number of participants to return. The service might return fewer
 *  than this value.
 *  If unspecified, at most 100 participants are returned.
 *  The maximum value is 250; values above 250 are coerced to 250.
 *  Maximum might change in the future.
 */
// const pageSize = 1234
/**
 *  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:
 *  * `earliest_start_time`
 *  * `latest_end_time`
 *  For example, `latest_end_time IS NULL` returns active participants in
 *  the conference.
 */
// const filter = 'abc123'

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

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

async function callListParticipants() {
  // Construct request
  const request = {
    parent,
  };

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

callListParticipants();

Питон

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

    # Initialize request argument(s)
    request = meet_v2.ListParticipantsRequest(
        parent="parent_value",
    )

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

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

Замените родительское значение именем записи конференции.

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

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

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

  • pageToken : токен страницы, полученный в результате предыдущего вызова списка. Предоставьте этот токен, чтобы получить следующую страницу.

  • filter : Необязательно. Фильтр запросов для получения определенных элементов в результатах ресурсов participants .

    Вы можете использовать поля earliestStartTime или latestEndTime для фильтрации пользователей, которые присоединились до или ушли после определенного времени. В обоих полях используется формат отметки времени в формате RFC 3339 UTC «Zulu» с наносекундным разрешением и до девяти дробных цифр: {year}-{month}-{day}T{hour}:{min}:{sec}[.{frac_sec}]Z . Например:

    • earliestStartTime < 2023-10-01T15:01:23Z
    • latestEndTime < 2023-10-01T15:01:23Z

    Чтобы вывести список всех активных участников существующей конференции, используйте latestEndTime IS NULL .

Получение сведений об участниках с помощью People API

Чтобы получить сведения об участнике, используйте метод get() ресурса people в People API.

  1. Извлеките идентификатор человека из ресурса participant используя конечный компонент пути. Например, если значение ресурса participant — conferenceRecords/abc-123/participants/12345 идентификатор People API — 12345 .

  2. Включите READ_SOURCE_TYPE_PROFILE , READ_SOURCE_TYPE_CONTACT и READ_SOURCE_TYPE_OTHER_CONTACT ReadSourceType . Это гарантирует, что в ответ будут включены как внутренние пользователи организации Google Workspace, так и внешние контакты.

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

КУЛЬ 

curl \
   'https://people.googleapis.com/v1/people/PERSON_ID?personFields=names%2CemailAddresses&sources=READ_SOURCE_TYPE_OTHER_CONTACT&sources=READ_SOURCE_TYPE_PROFILE&sources=READ_SOURCE_TYPE_CONTACT' \
   --header 'Authorization: Bearer ACCESS_TOKEN' \
   --header 'Accept: application/json' \
   --compressed

Замените следующее:

  • PERSON_ID : идентификатор человека, которого нужно найти.
  • ACCESS_TOKEN : токен доступа, предоставляющий доступ к нескольким API.

Сессии участников

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

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

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

Метод возвращает имя участника как экземпляр ресурса participantSessions .

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

Ява

java-meet/samples/snippets/generated/com/google/apps/meet/v2/conferencerecordsservice/getparticipantsession/AsyncGetParticipantSession.java
import com.google.api.core.ApiFuture;
import com.google.apps.meet.v2.ConferenceRecordsServiceClient;
import com.google.apps.meet.v2.GetParticipantSessionRequest;
import com.google.apps.meet.v2.ParticipantSession;
import com.google.apps.meet.v2.ParticipantSessionName;

public class AsyncGetParticipantSession {

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

  public static void asyncGetParticipantSession() 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()) {
      GetParticipantSessionRequest request =
          GetParticipantSessionRequest.newBuilder()
              .setName(
                  ParticipantSessionName.of(
                          "[CONFERENCE_RECORD]", "[PARTICIPANT]", "[PARTICIPANT_SESSION]")
                      .toString())
              .build();
      ApiFuture<ParticipantSession> future =
          conferenceRecordsServiceClient.getParticipantSessionCallable().futureCall(request);
      // Do something.
      ParticipantSession response = future.get();
    }
  }
}

Node.js

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

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

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

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

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

callGetParticipantSession();

Питон

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

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

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

    # Handle the response
    print(response)

Замените имя участника именем конкретного идентификатора сеанса участника в сеансе участника.

Список всех сеансов участников

Чтобы просмотреть подробную информацию обо всех сеансах участника в записи конференции, используйте метод list() ресурса participantSessions с параметром parent пути. Формат: conferenceRecords/{conferenceRecord}/participants/{participant} .

Метод возвращает список сеансов участников, упорядоченный по startTime в порядке убывания, как экземпляр ресурса participantSession . Чтобы настроить размер страницы и отфильтровать результаты запроса, см . раздел Настройка нумерации страниц или фильтрация списка сеансов участников .

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

Ява

java-meet/samples/snippets/generated/com/google/apps/meet/v2/conferencerecordsservice/listparticipantsessions/AsyncListParticipantSessions.java
import com.google.api.core.ApiFuture;
import com.google.apps.meet.v2.ConferenceRecordsServiceClient;
import com.google.apps.meet.v2.ListParticipantSessionsRequest;
import com.google.apps.meet.v2.ParticipantName;
import com.google.apps.meet.v2.ParticipantSession;

public class AsyncListParticipantSessions {

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

  public static void asyncListParticipantSessions() 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()) {
      ListParticipantSessionsRequest request =
          ListParticipantSessionsRequest.newBuilder()
              .setParent(ParticipantName.of("[CONFERENCE_RECORD]", "[PARTICIPANT]").toString())
              .setPageSize(883849137)
              .setPageToken("pageToken873572522")
              .setFilter("filter-1274492040")
              .build();
      ApiFuture<ParticipantSession> future =
          conferenceRecordsServiceClient.listParticipantSessionsPagedCallable().futureCall(request);
      // Do something.
      for (ParticipantSession element : future.get().iterateAll()) {
        // doThingsWith(element);
      }
    }
  }
}

Node.js

packages/google-apps-meet/samples/generated/v2/conference_records_service.list_participant_sessions.js
// Copyright 2025 Google LLC
//
// Licensed under the Apache License, Version 2.0 (the "License");
// you may not use this file except in compliance with the License.
// You may obtain a copy of the License at
//
//     https://www.apache.org/licenses/LICENSE-2.0
//
// Unless required by applicable law or agreed to in writing, software
// distributed under the License is distributed on an "AS IS" BASIS,
// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
// See the License for the specific language governing permissions and
// limitations under the License.
//
// ** This file is automatically generated by gapic-generator-typescript. **
// ** https://github.com/googleapis/gapic-generator-typescript **
// ** All changes to this file may be overwritten. **



'use strict';

function main(parent) {
  /**
   * 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. Format:
   *  `conferenceRecords/{conference_record}/participants/{participant}`
   */
  // const parent = 'abc123'
  /**
   *  Optional. Maximum number of participant sessions to return. The service
   *  might return fewer than this value. If unspecified, at most 100
   *  participants are returned. The maximum value is 250; values above 250 are
   *  coerced to 250. 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:
   *  * `start_time`
   *  * `end_time`
   *  For example, `end_time IS NULL` returns active participant sessions in
   *  the conference record.
   */
  // const filter = 'abc123'

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

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

  async function callListParticipantSessions() {
    // Construct request
    const request = {
      parent,
    };

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

  callListParticipantSessions();
}

process.on('unhandledRejection', err => {
  console.error(err.message);
  process.exitCode = 1;
});
main(...process.argv.slice(2));

Питон

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

    # Initialize request argument(s)
    request = meet_v2.ListParticipantSessionsRequest(
        parent="parent_value",
    )

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

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

Замените родительское значение именем сеансов участника в записи конференции.

Настройте нумерацию страниц или отфильтруйте список сеансов участников.

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

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

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

  • filter : Необязательно. Фильтр запросов для получения определенных элементов в результатах ресурсов participants .

    Вы можете использовать поля startTime или endTime для фильтрации пользователей, которые присоединились до или ушли после определенного времени. В обоих полях используется формат отметки времени в формате RFC 3339 UTC «Zulu» с наносекундным разрешением и до девяти дробных цифр: {year}-{month}-{day}T{hour}:{min}:{sec}[.{frac_sec}]Z . Например:

    • startTime < 2023-10-01T15:01:23Z
    • endTime < 2023-10-01T15:01:23Z

    Чтобы перечислить все сеансы активных участников в записи конференции, используйте endTime IS NULL .

,

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

Участник — это человек, присоединившийся к вызову или использующий режим Companion , наблюдающий за происходящим в качестве зрителя, или устройство в комнате, подключенное к вызову. Для каждого человека имеется один ресурс participants .

Сеанс участника — это уникальный идентификатор сеанса, созданный для каждой пары участник-устройство, которая присоединяется к вызову. Для каждого сеанса существует один ресурс participantSessions . Если участник присоединяется к одному и тому же вызову несколько раз с одной и той же пары участник-устройство, каждому из них присваиваются уникальные идентификаторы сеанса.

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

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

Участники

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

Ресурсы participants объединяются с user полем. user может быть только одним из следующих объектов:

  • signedinUser — это либо:

    • Человек, присоединяющийся с персонального компьютера, мобильного устройства или через режим Companion.

    • Учетная запись робота, используемая устройствами конференц-зала.

  • anonymousUser — это неопознанный пользователь, не вошедший в учетную запись Google.

  • phoneUser — это пользователь, звонящий с телефона, личность которого неизвестна, поскольку он не вошел в систему с помощью учетной записи Google.

Обратите внимание: хотя все три объекта возвращают displayName , signedinUser также возвращает уникальный идентификатор user , совместимый с API Admin SDK и People API. Формат: users/{user} . Дополнительные сведения об использовании идентификатора user с API People см. в разделе Получение сведений об участниках с помощью API People .

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

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

Метод возвращает данные участника как экземпляр ресурса participants .

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

Ява

java-meet/samples/snippets/generated/com/google/apps/meet/v2/conferencerecordsservice/getparticipant/AsyncGetParticipant.java
import com.google.api.core.ApiFuture;
import com.google.apps.meet.v2.ConferenceRecordsServiceClient;
import com.google.apps.meet.v2.GetParticipantRequest;
import com.google.apps.meet.v2.Participant;
import com.google.apps.meet.v2.ParticipantName;

public class AsyncGetParticipant {

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

  public static void asyncGetParticipant() 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()) {
      GetParticipantRequest request =
          GetParticipantRequest.newBuilder()
              .setName(ParticipantName.of("[CONFERENCE_RECORD]", "[PARTICIPANT]").toString())
              .build();
      ApiFuture<Participant> future =
          conferenceRecordsServiceClient.getParticipantCallable().futureCall(request);
      // Do something.
      Participant response = future.get();
    }
  }
}

Node.js

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

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

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

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

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

callGetParticipant();

Питон

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

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

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

    # Handle the response
    print(response)

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

Список всех участников

Чтобы просмотреть сведения обо всех участниках записи конференции, используйте метод list() ресурса participants с параметром parent пути. Формат: conferenceRecords/{conferenceRecord} .

Метод возвращает список участников конференции, упорядоченный по значению earliestStartTime в порядке убывания, как экземпляр ресурса participants . Чтобы настроить размер страницы и отфильтровать результаты запроса, см. раздел Настройка нумерации страниц или фильтрация списка участников .

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

Ява

java-meet/samples/snippets/generated/com/google/apps/meet/v2/conferencerecordsservice/listparticipants/AsyncListParticipants.java
import com.google.api.core.ApiFuture;
import com.google.apps.meet.v2.ConferenceRecordName;
import com.google.apps.meet.v2.ConferenceRecordsServiceClient;
import com.google.apps.meet.v2.ListParticipantsRequest;
import com.google.apps.meet.v2.Participant;

public class AsyncListParticipants {

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

  public static void asyncListParticipants() 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()) {
      ListParticipantsRequest request =
          ListParticipantsRequest.newBuilder()
              .setParent(ConferenceRecordName.of("[CONFERENCE_RECORD]").toString())
              .setPageSize(883849137)
              .setPageToken("pageToken873572522")
              .setFilter("filter-1274492040")
              .build();
      ApiFuture<Participant> future =
          conferenceRecordsServiceClient.listParticipantsPagedCallable().futureCall(request);
      // Do something.
      for (Participant element : future.get().iterateAll()) {
        // doThingsWith(element);
      }
    }
  }
}

Node.js

packages/google-apps-meet/samples/generated/v2/conference_records_service.list_participants.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. Format: `conferenceRecords/{conference_record}`
 */
// const parent = 'abc123'
/**
 *  Maximum number of participants to return. The service might return fewer
 *  than this value.
 *  If unspecified, at most 100 participants are returned.
 *  The maximum value is 250; values above 250 are coerced to 250.
 *  Maximum might change in the future.
 */
// const pageSize = 1234
/**
 *  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:
 *  * `earliest_start_time`
 *  * `latest_end_time`
 *  For example, `latest_end_time IS NULL` returns active participants in
 *  the conference.
 */
// const filter = 'abc123'

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

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

async function callListParticipants() {
  // Construct request
  const request = {
    parent,
  };

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

callListParticipants();

Питон

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

    # Initialize request argument(s)
    request = meet_v2.ListParticipantsRequest(
        parent="parent_value",
    )

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

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

Замените родительское значение именем записи конференции.

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

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

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

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

  • filter : Необязательно. Фильтр запросов для получения определенных элементов в результатах ресурсов participants .

    Вы можете использовать поля earliestStartTime или latestEndTime для фильтрации пользователей, которые присоединились до или ушли после определенного времени. В обоих полях используется формат отметки времени в формате RFC 3339 UTC «Zulu» с наносекундным разрешением и до девяти дробных цифр: {year}-{month}-{day}T{hour}:{min}:{sec}[.{frac_sec}]Z . Например:

    • earliestStartTime < 2023-10-01T15:01:23Z
    • latestEndTime < 2023-10-01T15:01:23Z

    Чтобы вывести список всех активных участников существующей конференции, используйте latestEndTime IS NULL .

Получение сведений об участниках с помощью People API

Чтобы получить сведения об участнике, используйте метод get() ресурса people в People API.

  1. Извлеките идентификатор человека из ресурса participant используя конечный компонент пути. Например, если значение ресурса participant — conferenceRecords/abc-123/participants/12345 идентификатор People API — 12345 .

  2. Включите READ_SOURCE_TYPE_PROFILE , READ_SOURCE_TYPE_CONTACT и READ_SOURCE_TYPE_OTHER_CONTACT ReadSourceType . Это гарантирует, что в ответ будут включены как внутренние пользователи организации Google Workspace, так и внешние контакты.

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

КУЛЬ 

curl \
   'https://people.googleapis.com/v1/people/PERSON_ID?personFields=names%2CemailAddresses&sources=READ_SOURCE_TYPE_OTHER_CONTACT&sources=READ_SOURCE_TYPE_PROFILE&sources=READ_SOURCE_TYPE_CONTACT' \
   --header 'Authorization: Bearer ACCESS_TOKEN' \
   --header 'Accept: application/json' \
   --compressed

Замените следующее:

  • PERSON_ID : идентификатор человека, которого нужно найти.
  • ACCESS_TOKEN : токен доступа, предоставляющий доступ к нескольким API.

Сессии участников

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

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

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

Метод возвращает имя участника как экземпляр ресурса participantSessions .

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

Ява

java-meet/samples/snippets/generated/com/google/apps/meet/v2/conferencerecordsservice/getparticipantsession/AsyncGetParticipantSession.java
import com.google.api.core.ApiFuture;
import com.google.apps.meet.v2.ConferenceRecordsServiceClient;
import com.google.apps.meet.v2.GetParticipantSessionRequest;
import com.google.apps.meet.v2.ParticipantSession;
import com.google.apps.meet.v2.ParticipantSessionName;

public class AsyncGetParticipantSession {

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

  public static void asyncGetParticipantSession() 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()) {
      GetParticipantSessionRequest request =
          GetParticipantSessionRequest.newBuilder()
              .setName(
                  ParticipantSessionName.of(
                          "[CONFERENCE_RECORD]", "[PARTICIPANT]", "[PARTICIPANT_SESSION]")
                      .toString())
              .build();
      ApiFuture<ParticipantSession> future =
          conferenceRecordsServiceClient.getParticipantSessionCallable().futureCall(request);
      // Do something.
      ParticipantSession response = future.get();
    }
  }
}

Node.js

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

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

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

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

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

callGetParticipantSession();

Питон

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

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

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

    # Handle the response
    print(response)

Замените имя участника именем конкретного идентификатора сеанса участника в сеансе участника.

Список всех сеансов участников

Чтобы просмотреть подробную информацию обо всех сеансах участника в записи конференции, используйте метод list() ресурса participantSessions с параметром parent пути. Формат: conferenceRecords/{conferenceRecord}/participants/{participant} .

Метод возвращает список сеансов участников, упорядоченный по startTime в порядке убывания, как экземпляр ресурса participantSession . Чтобы настроить размер страницы и отфильтровать результаты запроса, см . раздел Настройка нумерации страниц или фильтрация списка сеансов участников .

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

Ява

java-meet/samples/snippets/generated/com/google/apps/meet/v2/conferencerecordsservice/listparticipantsessions/AsyncListParticipantSessions.java
import com.google.api.core.ApiFuture;
import com.google.apps.meet.v2.ConferenceRecordsServiceClient;
import com.google.apps.meet.v2.ListParticipantSessionsRequest;
import com.google.apps.meet.v2.ParticipantName;
import com.google.apps.meet.v2.ParticipantSession;

public class AsyncListParticipantSessions {

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

  public static void asyncListParticipantSessions() 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()) {
      ListParticipantSessionsRequest request =
          ListParticipantSessionsRequest.newBuilder()
              .setParent(ParticipantName.of("[CONFERENCE_RECORD]", "[PARTICIPANT]").toString())
              .setPageSize(883849137)
              .setPageToken("pageToken873572522")
              .setFilter("filter-1274492040")
              .build();
      ApiFuture<ParticipantSession> future =
          conferenceRecordsServiceClient.listParticipantSessionsPagedCallable().futureCall(request);
      // Do something.
      for (ParticipantSession element : future.get().iterateAll()) {
        // doThingsWith(element);
      }
    }
  }
}

Node.js

packages/google-apps-meet/samples/generated/v2/conference_records_service.list_participant_sessions.js
// Copyright 2025 Google LLC
//
// Licensed under the Apache License, Version 2.0 (the "License");
// you may not use this file except in compliance with the License.
// You may obtain a copy of the License at
//
//     https://www.apache.org/licenses/LICENSE-2.0
//
// Unless required by applicable law or agreed to in writing, software
// distributed under the License is distributed on an "AS IS" BASIS,
// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
// See the License for the specific language governing permissions and
// limitations under the License.
//
// ** This file is automatically generated by gapic-generator-typescript. **
// ** https://github.com/googleapis/gapic-generator-typescript **
// ** All changes to this file may be overwritten. **



'use strict';

function main(parent) {
  /**
   * 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. Format:
   *  `conferenceRecords/{conference_record}/participants/{participant}`
   */
  // const parent = 'abc123'
  /**
   *  Optional. Maximum number of participant sessions to return. The service
   *  might return fewer than this value. If unspecified, at most 100
   *  participants are returned. The maximum value is 250; values above 250 are
   *  coerced to 250. 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:
   *  * `start_time`
   *  * `end_time`
   *  For example, `end_time IS NULL` returns active participant sessions in
   *  the conference record.
   */
  // const filter = 'abc123'

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

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

  async function callListParticipantSessions() {
    // Construct request
    const request = {
      parent,
    };

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

  callListParticipantSessions();
}

process.on('unhandledRejection', err => {
  console.error(err.message);
  process.exitCode = 1;
});
main(...process.argv.slice(2));

Питон

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

    # Initialize request argument(s)
    request = meet_v2.ListParticipantSessionsRequest(
        parent="parent_value",
    )

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

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

Замените родительское значение именем сеансов участника в записи конференции.

Настройте нумерацию страниц или отфильтруйте список сеансов участников.

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

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

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

  • filter : Необязательно. Фильтр запросов для получения определенных элементов в результатах ресурсов participants .

    Вы можете использовать поля startTime или endTime для фильтрации пользователей, которые присоединились до или ушли после определенного времени. В обоих полях используется формат отметки времени в формате RFC 3339 UTC «Zulu» с наносекундным разрешением и до девяти дробных цифр: {year}-{month}-{day}T{hour}:{min}:{sec}[.{frac_sec}]Z . Например:

    • startTime < 2023-10-01T15:01:23Z
    • endTime < 2023-10-01T15:01:23Z

    Чтобы перечислить все сеансы активных участников в записи конференции, используйте endTime IS NULL .

,

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

Участник — это человек, присоединившийся к вызову или использующий режим Companion , наблюдающий за происходящим в качестве зрителя, или устройство в комнате, подключенное к вызову. Для каждого человека имеется один ресурс participants .

Сеанс участника — это уникальный идентификатор сеанса, созданный для каждой пары участник-устройство, которая присоединяется к вызову. Для каждого сеанса существует один ресурс participantSessions . Если участник присоединяется к одному и тому же вызову несколько раз с одной и той же пары участник-устройство, каждому из них присваиваются уникальные идентификаторы сеанса.

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

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

Участники

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

Ресурсы participants объединяются с user полем. user может быть только одним из следующих объектов:

  • signedinUser — это либо:

    • Человек, присоединяющийся с персонального компьютера, мобильного устройства или через режим Companion.

    • Учетная запись робота, используемая устройствами конференц-зала.

  • anonymousUser — это неопознанный пользователь, который не вошел в учетную запись Google.

  • phoneUser — это пользователь, звонящий с телефона, личность которого неизвестна, поскольку он не вошел в систему с помощью учетной записи Google.

Обратите внимание: хотя все три объекта возвращают displayName , signedinUser также возвращает уникальный идентификатор user , совместимый с API Admin SDK и People API. Формат: users/{user} . Дополнительные сведения об использовании идентификатора user с API People см. в разделе Получение сведений об участниках с помощью API People .

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

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

Метод возвращает данные участника как экземпляр ресурса participants .

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

Ява

java-meet/samples/snippets/generated/com/google/apps/meet/v2/conferencerecordsservice/getparticipant/AsyncGetParticipant.java
import com.google.api.core.ApiFuture;
import com.google.apps.meet.v2.ConferenceRecordsServiceClient;
import com.google.apps.meet.v2.GetParticipantRequest;
import com.google.apps.meet.v2.Participant;
import com.google.apps.meet.v2.ParticipantName;

public class AsyncGetParticipant {

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

  public static void asyncGetParticipant() 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()) {
      GetParticipantRequest request =
          GetParticipantRequest.newBuilder()
              .setName(ParticipantName.of("[CONFERENCE_RECORD]", "[PARTICIPANT]").toString())
              .build();
      ApiFuture<Participant> future =
          conferenceRecordsServiceClient.getParticipantCallable().futureCall(request);
      // Do something.
      Participant response = future.get();
    }
  }
}

Node.js

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

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

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

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

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

callGetParticipant();

Питон

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

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

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

    # Handle the response
    print(response)

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

Список всех участников

Чтобы просмотреть сведения обо всех участниках записи конференции, используйте метод list() ресурса participants с параметром parent пути. Формат: conferenceRecords/{conferenceRecord} .

Метод возвращает список участников конференции, упорядоченный по значению earliestStartTime в порядке убывания, как экземпляр ресурса participants . Чтобы настроить размер страницы и отфильтровать результаты запроса, см. раздел Настройка нумерации страниц или фильтрация списка участников .

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

Ява

java-meet/samples/snippets/generated/com/google/apps/meet/v2/conferencerecordsservice/listparticipants/AsyncListParticipants.java
import com.google.api.core.ApiFuture;
import com.google.apps.meet.v2.ConferenceRecordName;
import com.google.apps.meet.v2.ConferenceRecordsServiceClient;
import com.google.apps.meet.v2.ListParticipantsRequest;
import com.google.apps.meet.v2.Participant;

public class AsyncListParticipants {

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

  public static void asyncListParticipants() 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()) {
      ListParticipantsRequest request =
          ListParticipantsRequest.newBuilder()
              .setParent(ConferenceRecordName.of("[CONFERENCE_RECORD]").toString())
              .setPageSize(883849137)
              .setPageToken("pageToken873572522")
              .setFilter("filter-1274492040")
              .build();
      ApiFuture<Participant> future =
          conferenceRecordsServiceClient.listParticipantsPagedCallable().futureCall(request);
      // Do something.
      for (Participant element : future.get().iterateAll()) {
        // doThingsWith(element);
      }
    }
  }
}

Node.js

packages/google-apps-meet/samples/generated/v2/conference_records_service.list_participants.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. Format: `conferenceRecords/{conference_record}`
 */
// const parent = 'abc123'
/**
 *  Maximum number of participants to return. The service might return fewer
 *  than this value.
 *  If unspecified, at most 100 participants are returned.
 *  The maximum value is 250; values above 250 are coerced to 250.
 *  Maximum might change in the future.
 */
// const pageSize = 1234
/**
 *  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:
 *  * `earliest_start_time`
 *  * `latest_end_time`
 *  For example, `latest_end_time IS NULL` returns active participants in
 *  the conference.
 */
// const filter = 'abc123'

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

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

async function callListParticipants() {
  // Construct request
  const request = {
    parent,
  };

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

callListParticipants();

Питон

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

    # Initialize request argument(s)
    request = meet_v2.ListParticipantsRequest(
        parent="parent_value",
    )

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

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

Замените родительское значение именем записи конференции.

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

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

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

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

  • filter : Необязательно. Фильтр запросов для получения определенных элементов в результатах ресурсов participants .

    Вы можете использовать поля earliestStartTime или latestEndTime для фильтрации пользователей, которые присоединились до или ушли после определенного времени. В обоих полях используется формат отметки времени в формате RFC 3339 UTC «Zulu» с наносекундным разрешением и до девяти дробных цифр: {year}-{month}-{day}T{hour}:{min}:{sec}[.{frac_sec}]Z . Например:

    • earliestStartTime < 2023-10-01T15:01:23Z
    • latestEndTime < 2023-10-01T15:01:23Z

    Чтобы вывести список всех активных участников существующей конференции, используйте latestEndTime IS NULL .

Получение сведений об участниках с помощью People API

Чтобы получить сведения об участнике, используйте метод get() ресурса people в People API.

  1. Извлеките идентификатор человека из ресурса participant используя конечный компонент пути. Например, если значение ресурса participant — conferenceRecords/abc-123/participants/12345 идентификатор People API — 12345 .

  2. Включите READ_SOURCE_TYPE_PROFILE , READ_SOURCE_TYPE_CONTACT и READ_SOURCE_TYPE_OTHER_CONTACT ReadSourceType . Это гарантирует, что в ответ будут включены как внутренние пользователи организации Google Workspace, так и внешние контакты.

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

КУЛЬ 

curl \
   'https://people.googleapis.com/v1/people/PERSON_ID?personFields=names%2CemailAddresses&sources=READ_SOURCE_TYPE_OTHER_CONTACT&sources=READ_SOURCE_TYPE_PROFILE&sources=READ_SOURCE_TYPE_CONTACT' \
   --header 'Authorization: Bearer ACCESS_TOKEN' \
   --header 'Accept: application/json' \
   --compressed

Замените следующее:

  • PERSON_ID : идентификатор человека, которого нужно найти.
  • ACCESS_TOKEN : токен доступа, предоставляющий доступ к нескольким API.

Сессии участников

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

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

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

Метод возвращает имя участника как экземпляр ресурса participantSessions .

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

Ява

java-meet/samples/snippets/generated/com/google/apps/meet/v2/conferencerecordsservice/getparticipantsession/AsyncGetParticipantSession.java
import com.google.api.core.ApiFuture;
import com.google.apps.meet.v2.ConferenceRecordsServiceClient;
import com.google.apps.meet.v2.GetParticipantSessionRequest;
import com.google.apps.meet.v2.ParticipantSession;
import com.google.apps.meet.v2.ParticipantSessionName;

public class AsyncGetParticipantSession {

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

  public static void asyncGetParticipantSession() 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()) {
      GetParticipantSessionRequest request =
          GetParticipantSessionRequest.newBuilder()
              .setName(
                  ParticipantSessionName.of(
                          "[CONFERENCE_RECORD]", "[PARTICIPANT]", "[PARTICIPANT_SESSION]")
                      .toString())
              .build();
      ApiFuture<ParticipantSession> future =
          conferenceRecordsServiceClient.getParticipantSessionCallable().futureCall(request);
      // Do something.
      ParticipantSession response = future.get();
    }
  }
}

Node.js

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

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

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

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

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

callGetParticipantSession();

Питон

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

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

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

    # Handle the response
    print(response)

Замените имя участника именем конкретного идентификатора сеанса участника в сеансе участника.

Список всех сеансов участников

Чтобы просмотреть подробную информацию обо всех сеансах участника в записи конференции, используйте метод list() ресурса participantSessions с параметром parent пути. Формат: conferenceRecords/{conferenceRecord}/participants/{participant} .

Метод возвращает список сеансов участников, упорядоченный по startTime в порядке убывания, как экземпляр ресурса participantSession . Чтобы настроить размер страницы и отфильтровать результаты запроса, см . раздел Настройка нумерации страниц или фильтрация списка сеансов участников .

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

Ява

java-meet/samples/snippets/generated/com/google/apps/meet/v2/conferencerecordsservice/listparticipantsessions/AsyncListParticipantSessions.java
import com.google.api.core.ApiFuture;
import com.google.apps.meet.v2.ConferenceRecordsServiceClient;
import com.google.apps.meet.v2.ListParticipantSessionsRequest;
import com.google.apps.meet.v2.ParticipantName;
import com.google.apps.meet.v2.ParticipantSession;

public class AsyncListParticipantSessions {

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

  public static void asyncListParticipantSessions() 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()) {
      ListParticipantSessionsRequest request =
          ListParticipantSessionsRequest.newBuilder()
              .setParent(ParticipantName.of("[CONFERENCE_RECORD]", "[PARTICIPANT]").toString())
              .setPageSize(883849137)
              .setPageToken("pageToken873572522")
              .setFilter("filter-1274492040")
              .build();
      ApiFuture<ParticipantSession> future =
          conferenceRecordsServiceClient.listParticipantSessionsPagedCallable().futureCall(request);
      // Do something.
      for (ParticipantSession element : future.get().iterateAll()) {
        // doThingsWith(element);
      }
    }
  }
}

Node.js

packages/google-apps-meet/samples/generated/v2/conference_records_service.list_participant_sessions.js
// Copyright 2025 Google LLC
//
// Licensed under the Apache License, Version 2.0 (the "License");
// you may not use this file except in compliance with the License.
// You may obtain a copy of the License at
//
//     https://www.apache.org/licenses/LICENSE-2.0
//
// Unless required by applicable law or agreed to in writing, software
// distributed under the License is distributed on an "AS IS" BASIS,
// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
// See the License for the specific language governing permissions and
// limitations under the License.
//
// ** This file is automatically generated by gapic-generator-typescript. **
// ** https://github.com/googleapis/gapic-generator-typescript **
// ** All changes to this file may be overwritten. **



'use strict';

function main(parent) {
  /**
   * 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. Format:
   *  `conferenceRecords/{conference_record}/participants/{participant}`
   */
  // const parent = 'abc123'
  /**
   *  Optional. Maximum number of participant sessions to return. The service
   *  might return fewer than this value. If unspecified, at most 100
   *  participants are returned. The maximum value is 250; values above 250 are
   *  coerced to 250. 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:
   *  * `start_time`
   *  * `end_time`
   *  For example, `end_time IS NULL` returns active participant sessions in
   *  the conference record.
   */
  // const filter = 'abc123'

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

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

  async function callListParticipantSessions() {
    // Construct request
    const request = {
      parent,
    };

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

  callListParticipantSessions();
}

process.on('unhandledRejection', err => {
  console.error(err.message);
  process.exitCode = 1;
});
main(...process.argv.slice(2));

Питон

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

    # Initialize request argument(s)
    request = meet_v2.ListParticipantSessionsRequest(
        parent="parent_value",
    )

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

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

Замените родительское значение именем сеансов участника в записи конференции.

Настройте нумерацию страниц или отфильтруйте список сеансов участников.

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

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

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

  • filter : Необязательно. Фильтр запросов для получения определенных элементов в результатах ресурсов participants .

    Вы можете использовать поля startTime или endTime для фильтрации пользователей, которые присоединились до или ушли после определенного времени. В обоих полях используется формат отметки времени в формате RFC 3339 UTC «Zulu» с наносекундным разрешением и до девяти дробных цифр: {year}-{month}-{day}T{hour}:{min}:{sec}[.{frac_sec}]Z . Например:

    • startTime < 2023-10-01T15:01:23Z
    • endTime < 2023-10-01T15:01:23Z

    Чтобы перечислить все сеансы активных участников в записи конференции, используйте endTime IS NULL .