با شرکت کنندگان کار کنید

این راهنما توضیح می‌دهد که چگونه با استفاده از API REST گوگل میت، جزئیات مربوط به شرکت‌کنندگانی که در کنفرانس‌های قبلی شرکت کرده‌اند یا در یک کنفرانس فعال هستند را به همراه اطلاعات جلسه آنها دریافت کنید.

شرکت‌کننده شخصی است که به یک تماس پیوسته یا از حالت همراهی استفاده می‌کند، به عنوان بیننده تماشا می‌کند، یا یک دستگاه اتاق است که به یک تماس متصل است. برای هر فرد یک منبع participants وجود دارد.

یک جلسه شرکت‌کننده، یک شناسه جلسه منحصر به فرد است که برای هر جفت شرکت‌کننده-دستگاه که به یک تماس می‌پیوندد، ایجاد می‌شود. برای هر جلسه یک منبع participantSessions وجود دارد. اگر شرکت‌کننده چندین بار از یک جفت شرکت‌کننده-دستگاه به یک تماس بپیوندد، به هر یک از آنها شناسه‌های جلسه منحصر به فردی اختصاص داده می‌شود.

اگر شما مالک یا شرکت‌کننده‌ی فضای جلسه هستید، می‌توانید متدهای get() و list() را هم در منابع participants و هم در منابع participantSessions فراخوانی کنید تا رکوردهای شرکت‌کننده را بازیابی کنید.

احراز هویت و مجوزدهی با استفاده از اعتبارنامه‌های کاربر به برنامه‌های Google Meet اجازه می‌دهد تا به داده‌های کاربر دسترسی پیدا کرده و عملیات را از طرف کاربر احراز هویت‌شده انجام دهند. احراز هویت با واگذاری اختیارات در سطح دامنه به شما امکان می‌دهد تا حساب سرویس یک برنامه را برای دسترسی به داده‌های کاربران خود بدون نیاز به رضایت هر کاربر، مجاز کنید.

شرکت‌کنندگان

بخش‌های بعدی نحوه‌ی دریافت اطلاعات شرکت‌کنندگان در یک رکورد کنفرانس را شرح می‌دهند.

منبع participants با فیلد user ادغام می‌شود. یک user می‌تواند فقط یکی از اشیاء زیر باشد:

  • یک signedinUser یکی از موارد زیر است:

    • فردی که از طریق رایانه شخصی، دستگاه تلفن همراه یا از طریق حالت همراه (Companion mode) به سیستم متصل می‌شود.

    • یک حساب کاربری ربات که توسط دستگاه‌های اتاق کنفرانس استفاده می‌شود.

  • کاربر anonymousUser کاربری ناشناس است که به حساب گوگل خود وارد نشده است.

  • phoneUser کاربری است که از تلفنی که هویتش ناشناخته است تماس می‌گیرد زیرا با حساب گوگل وارد نشده است.

توجه داشته باشید که اگرچه هر سه شیء یک displayName برمی‌گردانند، signedinUser همچنین یک شناسه user منحصر به فرد را برمی‌گرداند که با Admin SDK API و People API قابل تعامل است. فرمت: users/{user} . برای اطلاعات بیشتر در مورد استفاده از شناسه user با People API، به بخش بازیابی جزئیات شرکت‌کننده با People API مراجعه کنید.

دریافت جزئیات مربوط به یک شرکت‌کننده

برای دریافت جزئیات مربوط به یک شرکت‌کننده خاص، از متد get() روی منبع participants به همراه پارامتر name path استفاده کنید. اگر نام شرکت‌کننده را نمی‌دانید، می‌توانید با استفاده از متد 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();
    }
  }
}

نود جی اس

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);
      }
    }
  }
}

نود جی اس

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 : حداکثر تعداد شرکت‌کنندگان برای بازگشت. سرویس ممکن است کمتر از این مقدار را برگرداند. اگر مشخص نشود، حداکثر ۱۰۰ شرکت‌کننده برگردانده می‌شود. حداکثر مقدار ۲۵۰ است؛ مقادیر بیش از ۲۵۰ به طور خودکار به ۲۵۰ تغییر می‌کنند.

  • pageToken : یک توکن صفحه که از فراخوانی لیست قبلی دریافت شده است. این توکن را برای بازیابی صفحه بعدی ارائه دهید.

  • filter : اختیاری. یک فیلتر پرس‌وجو برای بازیابی موارد خاص در نتایج منابع participants .

    شما می‌توانید از فیلدهای earliestStartTime یا latestEndTime برای فیلتر کردن کاربرانی که قبل از زمان مشخصی عضو شده‌اند یا بعد از آن عضو شده‌اند استفاده کنید. هر دو فیلد از قالب Timestamp در قالب 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 باشد، شناسه برای API People 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 path استفاده کنید. اگر نام جلسه‌ی شرکت‌کننده را نمی‌دانید، می‌توانید با استفاده از متد 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();
    }
  }
}

نود جی اس

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);
      }
    }
  }
}

نود جی اس

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 : حداکثر تعداد جلسات شرکت‌کنندگان برای برگرداندن. سرویس ممکن است کمتر از این مقدار را برگرداند. اگر مشخص نشود، حداکثر ۱۰۰ جلسه شرکت‌کنندگان برگردانده می‌شود. حداکثر مقدار ۲۵۰ است؛ مقادیر بیش از ۲۵۰ به طور خودکار به ۲۵۰ تغییر می‌کنند.

  • pageToken : یک توکن صفحه که از فراخوانی لیست قبلی دریافت شده است. این توکن را برای بازیابی صفحه بعدی ارائه دهید.

  • filter : اختیاری. یک فیلتر پرس‌وجو برای بازیابی موارد خاص در نتایج منابع participants .

    شما می‌توانید از فیلدهای startTime یا endTime برای فیلتر کردن کاربرانی که قبل از زمان مشخصی عضو شده‌اند یا بعد از آن خارج شده‌اند، استفاده کنید. هر دو فیلد از قالب Timestamp در 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 استفاده کنید.

،

این راهنما توضیح می‌دهد که چگونه با استفاده از API REST گوگل میت، جزئیات مربوط به شرکت‌کنندگانی که در کنفرانس‌های قبلی شرکت کرده‌اند یا در یک کنفرانس فعال هستند را به همراه اطلاعات جلسه آنها دریافت کنید.

شرکت‌کننده شخصی است که به یک تماس پیوسته یا از حالت همراهی استفاده می‌کند، به عنوان بیننده تماشا می‌کند، یا یک دستگاه اتاق است که به یک تماس متصل است. برای هر فرد یک منبع participants وجود دارد.

یک جلسه شرکت‌کننده، یک شناسه جلسه منحصر به فرد است که برای هر جفت شرکت‌کننده-دستگاه که به یک تماس می‌پیوندد، ایجاد می‌شود. برای هر جلسه یک منبع participantSessions وجود دارد. اگر شرکت‌کننده چندین بار از یک جفت شرکت‌کننده-دستگاه به یک تماس بپیوندد، به هر یک از آنها شناسه‌های جلسه منحصر به فردی اختصاص داده می‌شود.

اگر شما مالک یا شرکت‌کننده‌ی فضای جلسه هستید، می‌توانید متدهای get() و list() را هم در منابع participants و هم در منابع participantSessions فراخوانی کنید تا رکوردهای شرکت‌کننده را بازیابی کنید.

احراز هویت و مجوزدهی با استفاده از اعتبارنامه‌های کاربر به برنامه‌های Google Meet اجازه می‌دهد تا به داده‌های کاربر دسترسی پیدا کرده و عملیات را از طرف کاربر احراز هویت‌شده انجام دهند. احراز هویت با واگذاری اختیارات در سطح دامنه به شما امکان می‌دهد تا حساب سرویس یک برنامه را برای دسترسی به داده‌های کاربران خود بدون نیاز به رضایت هر کاربر، مجاز کنید.

شرکت‌کنندگان

بخش‌های بعدی نحوه‌ی دریافت اطلاعات شرکت‌کنندگان در یک رکورد کنفرانس را شرح می‌دهند.

منبع participants با فیلد user ادغام می‌شود. یک user می‌تواند فقط یکی از اشیاء زیر باشد:

  • یک signedinUser یکی از موارد زیر است:

    • فردی که از طریق رایانه شخصی، دستگاه تلفن همراه یا از طریق حالت همراه (Companion mode) به سیستم متصل می‌شود.

    • یک حساب کاربری ربات که توسط دستگاه‌های اتاق کنفرانس استفاده می‌شود.

  • کاربر anonymousUser کاربری ناشناس است که به حساب گوگل خود وارد نشده است.

  • phoneUser کاربری است که از تلفنی که هویتش ناشناخته است تماس می‌گیرد زیرا با حساب گوگل وارد نشده است.

توجه داشته باشید که اگرچه هر سه شیء یک displayName برمی‌گردانند، signedinUser همچنین یک شناسه user منحصر به فرد را برمی‌گرداند که با Admin SDK API و People API قابل تعامل است. فرمت: users/{user} . برای اطلاعات بیشتر در مورد استفاده از شناسه user با People API، به بخش بازیابی جزئیات شرکت‌کننده با People API مراجعه کنید.

دریافت جزئیات مربوط به یک شرکت‌کننده

برای دریافت جزئیات مربوط به یک شرکت‌کننده خاص، از متد get() روی منبع participants به همراه پارامتر name path استفاده کنید. اگر نام شرکت‌کننده را نمی‌دانید، می‌توانید با استفاده از متد 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();
    }
  }
}

نود جی اس

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);
      }
    }
  }
}

نود جی اس

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 : حداکثر تعداد شرکت‌کنندگان برای بازگشت. سرویس ممکن است کمتر از این مقدار را برگرداند. اگر مشخص نشود، حداکثر ۱۰۰ شرکت‌کننده برگردانده می‌شود. حداکثر مقدار ۲۵۰ است؛ مقادیر بیش از ۲۵۰ به طور خودکار به ۲۵۰ تغییر می‌کنند.

  • pageToken : یک توکن صفحه که از فراخوانی لیست قبلی دریافت شده است. این توکن را برای بازیابی صفحه بعدی ارائه دهید.

  • filter : اختیاری. یک فیلتر پرس‌وجو برای بازیابی موارد خاص در نتایج منابع participants .

    شما می‌توانید از فیلدهای earliestStartTime یا latestEndTime برای فیلتر کردن کاربرانی که قبل از زمان مشخصی عضو شده‌اند یا بعد از آن عضو شده‌اند استفاده کنید. هر دو فیلد از قالب Timestamp در قالب 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 باشد، شناسه برای API People 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 path استفاده کنید. اگر نام جلسه‌ی شرکت‌کننده را نمی‌دانید، می‌توانید با استفاده از متد 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();
    }
  }
}

نود جی اس

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);
      }
    }
  }
}

نود جی اس

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 : حداکثر تعداد جلسات شرکت‌کنندگان برای برگرداندن. سرویس ممکن است کمتر از این مقدار را برگرداند. اگر مشخص نشود، حداکثر ۱۰۰ جلسه شرکت‌کنندگان برگردانده می‌شود. حداکثر مقدار ۲۵۰ است؛ مقادیر بیش از ۲۵۰ به طور خودکار به ۲۵۰ تغییر می‌کنند.

  • pageToken : یک توکن صفحه که از فراخوانی لیست قبلی دریافت شده است. این توکن را برای بازیابی صفحه بعدی ارائه دهید.

  • filter : اختیاری. یک فیلتر پرس‌وجو برای بازیابی موارد خاص در نتایج منابع participants .

    شما می‌توانید از فیلدهای startTime یا endTime برای فیلتر کردن کاربرانی که قبل از زمان مشخصی عضو شده‌اند یا بعد از آن خارج شده‌اند، استفاده کنید. هر دو فیلد از قالب Timestamp در 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 استفاده کنید.

،

این راهنما توضیح می‌دهد که چگونه با استفاده از API REST گوگل میت، جزئیات مربوط به شرکت‌کنندگانی که در کنفرانس‌های قبلی شرکت کرده‌اند یا در یک کنفرانس فعال هستند را به همراه اطلاعات جلسه آنها دریافت کنید.

شرکت‌کننده شخصی است که به یک تماس پیوسته یا از حالت همراهی استفاده می‌کند، به عنوان بیننده تماشا می‌کند، یا یک دستگاه اتاق است که به یک تماس متصل است. برای هر فرد یک منبع participants وجود دارد.

یک جلسه شرکت‌کننده، یک شناسه جلسه منحصر به فرد است که برای هر جفت شرکت‌کننده-دستگاه که به یک تماس می‌پیوندد، ایجاد می‌شود. برای هر جلسه یک منبع participantSessions وجود دارد. اگر شرکت‌کننده چندین بار از یک جفت شرکت‌کننده-دستگاه به یک تماس بپیوندد، به هر یک از آنها شناسه‌های جلسه منحصر به فردی اختصاص داده می‌شود.

اگر شما مالک یا شرکت‌کننده‌ی فضای جلسه هستید، می‌توانید متدهای get() و list() را هم در منابع participants و هم در منابع participantSessions فراخوانی کنید تا رکوردهای شرکت‌کننده را بازیابی کنید.

احراز هویت و مجوزدهی با استفاده از اعتبارنامه‌های کاربر به برنامه‌های Google Meet اجازه می‌دهد تا به داده‌های کاربر دسترسی پیدا کرده و عملیات را از طرف کاربر احراز هویت‌شده انجام دهند. احراز هویت با واگذاری اختیارات در سطح دامنه به شما امکان می‌دهد تا حساب سرویس یک برنامه را برای دسترسی به داده‌های کاربران خود بدون نیاز به رضایت هر کاربر، مجاز کنید.

شرکت‌کنندگان

بخش‌های بعدی نحوه‌ی دریافت اطلاعات شرکت‌کنندگان در یک رکورد کنفرانس را شرح می‌دهند.

منبع participants با فیلد user ادغام می‌شود. یک user می‌تواند فقط یکی از اشیاء زیر باشد:

  • یک signedinUser یکی از موارد زیر است:

    • فردی که از طریق رایانه شخصی، دستگاه تلفن همراه یا از طریق حالت همراه (Companion mode) به سیستم متصل می‌شود.

    • یک حساب کاربری ربات که توسط دستگاه‌های اتاق کنفرانس استفاده می‌شود.

  • کاربر anonymousUser کاربری ناشناس است که به حساب گوگل خود وارد نشده است.

  • phoneUser کاربری است که از تلفنی که هویتش ناشناخته است تماس می‌گیرد زیرا با حساب گوگل وارد نشده است.

توجه داشته باشید که اگرچه هر سه شیء یک displayName برمی‌گردانند، signedinUser همچنین یک شناسه user منحصر به فرد را برمی‌گرداند که با Admin SDK API و People API قابل تعامل است. فرمت: users/{user} . برای اطلاعات بیشتر در مورد استفاده از شناسه user با People API، به بخش بازیابی جزئیات شرکت‌کننده با People API مراجعه کنید.

دریافت جزئیات مربوط به یک شرکت‌کننده

برای دریافت جزئیات مربوط به یک شرکت‌کننده خاص، از متد get() روی منبع participants به همراه پارامتر name path استفاده کنید. اگر نام شرکت‌کننده را نمی‌دانید، می‌توانید با استفاده از متد 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();
    }
  }
}

نود جی اس

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);
      }
    }
  }
}

نود جی اس

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 : حداکثر تعداد شرکت‌کنندگان برای بازگشت. سرویس ممکن است کمتر از این مقدار را برگرداند. اگر مشخص نشود، حداکثر ۱۰۰ شرکت‌کننده برگردانده می‌شود. حداکثر مقدار ۲۵۰ است؛ مقادیر بیش از ۲۵۰ به طور خودکار به ۲۵۰ تغییر می‌کنند.

  • pageToken : یک توکن صفحه که از فراخوانی لیست قبلی دریافت شده است. این توکن را برای بازیابی صفحه بعدی ارائه دهید.

  • filter : اختیاری. یک فیلتر پرس‌وجو برای بازیابی موارد خاص در نتایج منابع participants .

    شما می‌توانید از فیلدهای earliestStartTime یا latestEndTime برای فیلتر کردن کاربرانی که قبل از زمان مشخصی عضو شده‌اند یا بعد از آن عضو شده‌اند استفاده کنید. هر دو فیلد از قالب Timestamp در 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 باشد، شناسه برای API People 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 path استفاده کنید. اگر نام جلسه‌ی شرکت‌کننده را نمی‌دانید، می‌توانید با استفاده از متد 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();
    }
  }
}

نود جی اس

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);
      }
    }
  }
}

نود جی اس

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 : حداکثر تعداد جلسات شرکت‌کنندگان برای برگرداندن. سرویس ممکن است کمتر از این مقدار را برگرداند. اگر مشخص نشود، حداکثر ۱۰۰ جلسه شرکت‌کنندگان برگردانده می‌شود. حداکثر مقدار ۲۵۰ است؛ مقادیر بیش از ۲۵۰ به طور خودکار به ۲۵۰ تغییر می‌کنند.

  • pageToken : یک توکن صفحه که از فراخوانی لیست قبلی دریافت شده است. این توکن را برای بازیابی صفحه بعدی ارائه دهید.

  • filter : اختیاری. یک فیلتر پرس‌وجو برای بازیابی موارد خاص در نتایج منابع participants .

    شما می‌توانید از فیلدهای startTime یا endTime برای فیلتر کردن کاربرانی که قبل از زمان مشخصی عضو شده‌اند یا بعد از آن خارج شده‌اند، استفاده کنید. هر دو فیلد از قالب Timestamp در 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 استفاده کنید.