العمل مع المشاركين

يوضّح هذا الدليل كيفية الحصول على تفاصيل عن المشاركين الذين حضروا مؤتمرًا سابقًا أو الذين يشاركون في مؤتمر نشط، بالإضافة إلى معلومات الجلسة الخاصة بهم، باستخدام Google Meet REST API.

المشارك هو شخص انضم إلى مكالمة أو يستخدم وضع المزاملة أو يشاهد كمشاهد أو جهاز غرفة متصل بمكالمة. هناك مورد participants واحد لكل شخص.

جلسة المشارك هي معرّف جلسة فريد يتم إنشاؤه لكل زوج من المشاركين والأجهزة التي تنضم إلى مكالمة. هناك مورد واحد participantSessions لكل جلسة. إذا انضم المشارك إلى المكالمة نفسها عدة مرات من خلال الزوج نفسه من المشاركين والأجهزة، يتم تخصيص معرّفات جلسات فريدة لكل مرة.

إذا كنت مالك مساحة اجتماع أو مشاركًا فيها، يمكنك استدعاء الطريقتَين get وlist على كل من الموردَين participants وparticipantSessions لاسترداد سجلّات المشاركين.

يسمح لك المصادقة والتفويض باستخدام بيانات اعتماد المستخدم لتطبيقات Google Meet بالوصول إلى بيانات المستخدم وإجراء عمليات نيابةً عن المستخدم الذي تم التحقّق من هويته. تسمح لك المصادقة باستخدام التفويض على مستوى النطاق بتفويض حساب خدمة تطبيق للوصول إلى بيانات المستخدمين بدون طلب موافقة كل مستخدم.

مشارك

توضّح الأقسام التالية بالتفصيل كيفية الحصول على معلومات عن المشاركين في سجلّ مؤتمر.

يتّحد المورد participants مع الحقل user. يمكن أن يكون user أحد الكائنات التالية فقط:

  • A signedinUser هو أحد الخيارَين التاليَين:

    • مستخدم ينضم من جهاز كمبيوتر شخصي أو جهاز جوّال أو من خلال وضع المزاملة

    • حساب روبوت تستخدمه أجهزة غرف المؤتمرات

  • anonymousUser هو مستخدم غير محدّد الهوية لم يسجّل الدخول إلى حساب Google.

  • A phoneUser هو مستخدم يتصل من هاتف لا يُعرف فيه هوية المستخدم لأنّه لم يسجّل الدخول باستخدام حساب Google.

يُرجى العِلم أنّه على الرغم من أنّ جميع الكائنات الثلاثة تعرض displayName، يعرض signedinUser أيضًا user معرّفًا فريدًا يمكن استخدامه مع Admin SDK API وPeople API. التنسيق: users/{user}. لمزيد من المعلومات عن استخدام user المعرّف مع People API، يُرجى الاطّلاع على استرداد تفاصيل المشاركين باستخدام People API.

الحصول على تفاصيل عن مشارك

للحصول على تفاصيل عن مشارك معيّن، استخدِم الـ get على الـ participants. اضبط مَعلمة المسار name باستخدام التنسيق conferenceRecords/{conferenceRecord}/participants/{participantRecord}.

إذا كنت لا تعرف اسم المشارك، يمكنك عرض جميع أسماء المشاركين باستخدام الطريقة 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();

Python

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)

cURL

curl -X GET "https://meet.googleapis.com/v2/conferenceRecords/CONFERENCE_RECORD_NAME/participants/PARTICIPANT_NAME" \
-H "Authorization: Bearer ACCESS_TOKEN"

استبدِل ACCESS_TOKEN برمز الدخول الذي يمنح إذن الوصول إلى واجهة برمجة التطبيقات.

غيِّر القيم في السلسلة على الشكل التالي:

  • اسم سجلّ المؤتمر باسم معرّف المؤتمر المحدّد في سجلّ المؤتمر
  • اسم المشارك باسم معرّف المشارك المحدّد في سجلّ المؤتمر

عرض جميع المشاركين

لعرض تفاصيل عن جميع المشاركين في سجلّ مؤتمر، استخدِم الـ 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();

Python

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)

cURL

curl -X GET "https://meet.googleapis.com/v2/conferenceRecords/PARENT_NAME/participants" \
-H "Authorization: Bearer ACCESS_TOKEN"

استبدِل ACCESS_TOKEN برمز الدخول الذي يمنح إذن الوصول إلى واجهة برمجة التطبيقات.

استبدِل اسم العنصر الرئيسي باسم معرّف المؤتمر المحدّد في سجلّ المؤتمر.

تخصيص ترقيم الصفحات أو فلترة قائمة المشاركين

مرِّر مَعلمات طلب البحث التالية لتخصيص ترقيم الصفحات للمشاركين أو فلترتهم:

  • pageSize: الحد الأقصى لعدد المشاركين المطلوب عرضه. قد تعرض الخدمة عددًا أقل من هذه القيمة. إذا لم يتم تحديد عدد، يتم عرض 100 مشارك على الأكثر. الحد الأقصى للقيمة هو 250، ويتم تغيير القيم التي تزيد عن 250 تلقائيًا إلى 250.

  • pageToken: رمز صفحة تم استلامه من طلب `list` سابق. قدِّم هذا الرمز لاسترداد الصفحة التالية.

  • 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 method على الـ people resource في 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

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: رمز الدخول الذي يمنح إذن الوصول إلى واجهات برمجة تطبيقات متعددة

جلسات المشاركين

توضّح الأقسام التالية بالتفصيل كيفية الحصول على معلومات عن جلسات المشاركين في سجلّ مؤتمر.

الحصول على تفاصيل عن جلسة مشارك

للحصول على تفاصيل عن جلسة مشارك معيّنة، استخدِم الـ get على الـ participantSessions. اضبط مَعلمة المسار name باستخدام التنسيق conferenceRecords/{conferenceRecord}/participants/{participantRecord}/participantSessions/{participantSessionRecord}.

إذا كنت لا تعرف اسم جلسة المشارك، يمكنك عرض جميع جلسات المشارك باستخدام الطريقة 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();

Python

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)

cURL

curl -X GET "https://meet.googleapis.com/v2/conferenceRecords/CONFERENCE_RECORD_NAME/participants/PARTICIPANT_NAME/participantSessions/PARTICIPANT_SESSION_ID" \
-H "Authorization: Bearer ACCESS_TOKEN"

استبدِل ACCESS_TOKEN برمز الدخول الذي يمنح إذن الوصول إلى واجهة برمجة التطبيقات.

غيِّر القيم في السلسلة على الشكل التالي:

  • اسم سجلّ المؤتمر باسم معرّف المؤتمر المحدّد في سجلّ المؤتمر
  • اسم المشارك باسم معرّف المشارك المحدّد في سجلّ المؤتمر
  • معرّف جلسة المشارك بمعرّف جلسة المشارك المحدّدة

عرض جميع جلسات المشاركين

لعرض تفاصيل عن جميع جلسات المشاركين في سجلّ مؤتمر ، استخدِم list() الطريقة على participantSessions المورد. اضبط مَعلمة المسار parent باستخدام التنسيق conferenceRecords/{conferenceRecord}/participants/{participantRecord}.

تعرض الطريقة قائمة بجلسات المشاركين، مرتّبة حسب 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 2026 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));

Python

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)

cURL

curl -X GET "https://meet.googleapis.com/v2/conferenceRecords/CONFERENCE_RECORD_NAME/participants/PARENT_NAME/participantSessions" \
-H "Authorization: Bearer ACCESS_TOKEN"

استبدِل ACCESS_TOKEN برمز الدخول الذي يمنح إذن الوصول إلى واجهة برمجة التطبيقات.

غيِّر القيم في السلسلة على الشكل التالي:

  • اسم سجلّ المؤتمر باسم معرّف المؤتمر المحدّد في سجلّ المؤتمر
  • اسم العنصر الرئيسي باسم جلسات المشاركين في سجلّ المؤتمر

تخصيص ترقيم الصفحات أو فلترة قائمة جلسات المشاركين

مرِّر مَعلمات طلب البحث الاختيارية التالية لتخصيص ترقيم الصفحات لجلسات المشاركين أو فلترتها:

  • pageSize: الحد الأقصى لعدد جلسات المشاركين المطلوب عرضها. قد تعرض الخدمة عددًا أقل من هذه القيمة. إذا لم يتم تحديد عدد، يتم عرض 100 جلسة مشارك على الأكثر. الحد الأقصى للقيمة هو 250، ويتم تغيير القيم التي تزيد عن 250 تلقائيًا إلى 250.

  • pageToken: رمز صفحة تم استلامه من طلب `list` سابق. قدِّم هذا الرمز لاسترداد الصفحة التالية.

  • 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.