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

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

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

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

شرکت کنندگان

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

منبع conferenceRecords.participants شامل فیلد user است. یک user می تواند تنها یکی از اشیاء زیر باشد:

  • یک signedinUser یکی است:

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

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

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

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

جستجو برای همه شرکت کنندگان

برای دریافت جزئیات درباره همه شرکت کنندگان در یک رکورد کنفرانس، از متد list() در منبع conferenceRecords.participants با پارامتر مسیر parent استفاده کنید.

می‌توانید از فیلدهای 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 استفاده کنید.

این روش فهرستی از شرکت کنندگان در کنفرانس را که بر اساس زمان پیوستن به ترتیب نزولی مرتب شده اند، به عنوان نمونه ای از منبع conferenceRecords.participants برمی گرداند.

نمونه کد زیر نحوه فهرست کردن همه شرکت کنندگان در یک رکورد کنفرانس را نشان می دهد:

جاوا

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

public class AsyncListParticipants {

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

  public static void asyncListParticipants() throws Exception {
    // This snippet has been automatically generated and should be regarded as a code template only.
    // It will require modifications to work:
    // - It may require correct/in-range values for request initialization.
    // - It may require specifying regional endpoints when creating the service client as shown in
    // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
    try (ConferenceRecordsServiceClient conferenceRecordsServiceClient =
        ConferenceRecordsServiceClient.create()) {
      ListParticipantsRequest request =
          ListParticipantsRequest.newBuilder()
              .setParent(ConferenceRecordName.of("[CONFERENCE_RECORD]").toString())
              .setPageSize(883849137)
              .setPageToken("pageToken873572522")
              .setFilter("filter-1274492040")
              .build();
      ApiFuture<Participant> future =
          conferenceRecordsServiceClient.listParticipantsPagedCallable().futureCall(request);
      // Do something.
      for (Participant element : future.get().iterateAll()) {
        // doThingsWith(element);
      }
    }
  }
}

Node.js

packages/google-apps-meet/samples/generated/v2/conference_records_service.list_participants.js
/**
 * This snippet has been automatically generated and should be regarded as a code template only.
 * It will require modifications to work.
 * It may require correct/in-range values for request initialization.
 * TODO(developer): Uncomment these variables before running the sample.
 */
/**
 *  Required. Format: `conferenceRecords/{conference_record}`
 */
// const parent = 'abc123'
/**
 *  Maximum number of participants to return. The service might return fewer
 *  than this value.
 *  If unspecified, at most 100 participants are returned.
 *  The maximum value is 250; values above 250 are coerced to 250.
 *  Maximum might change in the future.
 */
// const pageSize = 1234
/**
 *  Page token returned from previous List Call.
 */
// const pageToken = 'abc123'
/**
 *  Optional. User specified filtering condition in EBNF
 *  format (https://en.wikipedia.org/wiki/Extended_Backus%E2%80%93Naur_form).
 *  The following are the filterable fields:
 *  * `earliest_start_time`
 *  * `latest_end_time`
 *  For example, `latest_end_time IS NULL` returns active participants in
 *  the conference.
 */
// const filter = 'abc123'

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

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

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

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

callListParticipants();

پایتون

packages/google-apps-meet/samples/generated_samples/meet_v2_generated_conference_records_service_list_participants_async.py
# This snippet has been automatically generated and should be regarded as a
# code template only.
# It will require modifications to work:
# - It may require correct/in-range values for request initialization.
# - It may require specifying regional endpoints when creating the service
#   client as shown in:
#   https://googleapis.dev/python/google-api-core/latest/client_options.html
from google.apps import meet_v2


async def sample_list_participants():
    # Create a client
    client = meet_v2.ConferenceRecordsServiceAsyncClient()

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

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

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

مقدار والد را با نام رکورد کنفرانس جایگزین کنید.

یک شرکت کننده خاص را جستجو کنید

برای جستجوی یک شرکت‌کننده خاص، از متد get() در منبع conferenceRecords.participants با پارامتر مسیر name استفاده کنید. برای بازیابی نام شرکت کننده، از روش conferenceRecords.participants.list استفاده کنید.

این روش نام شرکت کننده را به عنوان نمونه ای از یک منبع conferenceRecords.participants برمی گرداند.

نمونه کد زیر نحوه بازیابی یک شرکت‌کننده خاص را نشان می‌دهد:

جاوا

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

public class AsyncGetParticipant {

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

  public static void asyncGetParticipant() throws Exception {
    // This snippet has been automatically generated and should be regarded as a code template only.
    // It will require modifications to work:
    // - It may require correct/in-range values for request initialization.
    // - It may require specifying regional endpoints when creating the service client as shown in
    // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
    try (ConferenceRecordsServiceClient conferenceRecordsServiceClient =
        ConferenceRecordsServiceClient.create()) {
      GetParticipantRequest request =
          GetParticipantRequest.newBuilder()
              .setName(ParticipantName.of("[CONFERENCE_RECORD]", "[PARTICIPANT]").toString())
              .build();
      ApiFuture<Participant> future =
          conferenceRecordsServiceClient.getParticipantCallable().futureCall(request);
      // Do something.
      Participant response = future.get();
    }
  }
}

Node.js

packages/google-apps-meet/samples/generated/v2/conference_records_service.get_participant.js
/**
 * This snippet has been automatically generated and should be regarded as a code template only.
 * It will require modifications to work.
 * It may require correct/in-range values for request initialization.
 * TODO(developer): Uncomment these variables before running the sample.
 */
/**
 *  Required. Resource name of the participant.
 */
// const name = 'abc123'

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

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

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

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

callGetParticipant();

پایتون

packages/google-apps-meet/samples/generated_samples/meet_v2_generated_conference_records_service_get_participant_async.py
# This snippet has been automatically generated and should be regarded as a
# code template only.
# It will require modifications to work:
# - It may require correct/in-range values for request initialization.
# - It may require specifying regional endpoints when creating the service
#   client as shown in:
#   https://googleapis.dev/python/google-api-core/latest/client_options.html
from google.apps import meet_v2


async def sample_get_participant():
    # Create a client
    client = meet_v2.ConferenceRecordsServiceAsyncClient()

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

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

    # Handle the response
    print(response)

برای یافتن نام شرکت کننده را با نام شرکت کننده خاص جایگزین کنید.

جلسات شرکت کننده

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

جستجوی همه جلسات شرکت کننده

برای دریافت جزئیات در مورد تمام جلسات شرکت کننده یک شرکت کننده در یک رکورد کنفرانس، از روش list() در منبع conferenceRecords.participants.participantSessions با پارامتر مسیر parent استفاده کنید.

می‌توانید از فیلدهای 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

این روش فهرستی از جلسات شرکت‌کننده را که بر اساس زمان پیوستن به ترتیب نزولی مرتب شده‌اند، به عنوان نمونه‌ای از یک منبع conferenceRecords.participants.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 2024 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)

نام رکورد کنفرانس و نام شرکت کننده را جایگزین مقدار والد کنید.

برای یک جلسه شرکت کننده خاص جستجو کنید

برای جستجوی یک جلسه شرکت کننده خاص، از متد get() در منبع conferenceRecords.participants.participantSessions با پارامتر مسیر name استفاده کنید. برای بازیابی نام شرکت کننده، از متد list() استفاده کنید.

این روش نام شرکت کننده را به عنوان نمونه ای از یک منبع conferenceRecords.participants.participantSessions برمی گرداند.

نمونه کد زیر نحوه بازیابی یک جلسه شرکت کننده خاص را نشان می دهد:

جاوا

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

public class AsyncGetParticipantSession {

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

  public static void asyncGetParticipantSession() throws Exception {
    // This snippet has been automatically generated and should be regarded as a code template only.
    // It will require modifications to work:
    // - It may require correct/in-range values for request initialization.
    // - It may require specifying regional endpoints when creating the service client as shown in
    // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
    try (ConferenceRecordsServiceClient conferenceRecordsServiceClient =
        ConferenceRecordsServiceClient.create()) {
      GetParticipantSessionRequest request =
          GetParticipantSessionRequest.newBuilder()
              .setName(
                  ParticipantSessionName.of(
                          "[CONFERENCE_RECORD]", "[PARTICIPANT]", "[PARTICIPANT_SESSION]")
                      .toString())
              .build();
      ApiFuture<ParticipantSession> future =
          conferenceRecordsServiceClient.getParticipantSessionCallable().futureCall(request);
      // Do something.
      ParticipantSession response = future.get();
    }
  }
}

Node.js

packages/google-apps-meet/samples/generated/v2/conference_records_service.get_participant_session.js
/**
 * This snippet has been automatically generated and should be regarded as a code template only.
 * It will require modifications to work.
 * It may require correct/in-range values for request initialization.
 * TODO(developer): Uncomment these variables before running the sample.
 */
/**
 *  Required. Resource name of the participant.
 */
// const name = 'abc123'

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

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

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

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

callGetParticipantSession();

پایتون

packages/google-apps-meet/samples/generated_samples/meet_v2_generated_conference_records_service_get_participant_session_async.py
# This snippet has been automatically generated and should be regarded as a
# code template only.
# It will require modifications to work:
# - It may require correct/in-range values for request initialization.
# - It may require specifying regional endpoints when creating the service
#   client as shown in:
#   https://googleapis.dev/python/google-api-core/latest/client_options.html
from google.apps import meet_v2


async def sample_get_participant_session():
    # Create a client
    client = meet_v2.ConferenceRecordsServiceAsyncClient()

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

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

    # Handle the response
    print(response)

برای یافتن نام شرکت کننده را با نام شرکت کننده خاص جایگزین کنید.

جزئیات شرکت‌کننده را با People API بازیابی کنید

برای بازیابی جزئیات یک شرکت‌کننده، از روش people.get در People API استفاده کنید.

  1. شناسه شخص را از نام منبع شرکت کننده با استفاده از مؤلفه دنباله دار مسیر استخراج کنید. برای مثال، اگر نام منبع شرکت‌کننده conferenceRecords/abc-123/participants/12345 باشد، شناسه People API 12345 است.
  2. شامل منابع READ_SOURCE_TYPE_PROFILE ، READ_SOURCE_TYPE_CONTACT ، و READ_SOURCE_TYPE_OTHER_CONTACT . این تضمین می کند که هم کاربران داخلی یک سازمان 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