שיתוף פעולה עם המשתתפים

במדריך הזה מוסבר איך לקבל פרטים על משתתפים שהשתתפו בוועידה בעבר או שמשתתפים בוועידה פעילה, וגם מידע על הסשן שלהם, באמצעות Google Meet API בארכיטקטורת REST.

משתתף הוא אדם שהצטרף לשיחה או שמשתמש במצב Companion, צופה בה כצופה או משתמש במכשיר בחדר שמחובר לשיחה. יש משאב אחד participants לכל אדם.

סשן של משתתף הוא מזהה סשן ייחודי שנוצר לכל זוג של משתתף ומכשיר שמצטרף לשיחה. יש משאב אחד של participantSessions לכל סשן. אם המשתתף מצטרף לאותה שיחה כמה פעמים מאותו זוג של משתתף ומכשיר, לכל הצטרפות מוקצה מזהה סשן ייחודי.

אם אתם הבעלים של המרחב או משתתפים בו, אתם יכולים להפעיל את השיטות get ו-list במשאבים participants ו-participantSessions כדי לאחזר את רשומות המשתתפים.

אימות ומתן הרשאה באמצעות פרטי כניסה של משתמשים מאפשרים לאפליקציות של Google Meet לגשת לנתוני משתמשים ולבצע פעולות בשם המשתמש המאומת. אימות באמצעות הענקת הרשאות גישה ברמת הדומיין מאפשר לתת הרשאה לחשבון השירות של אפליקציה לגשת לנתונים של המשתמשים בלי שכל משתמש יצטרך לתת את ההסכמה שלו.

משתתפים

בקטעים הבאים מוסבר איך לקבל מידע על משתתפים בהקלטה של שיחת ועידה.

האיחודים של משאבי participants עם השדה user. הערך user יכול להיות רק אחד מהאובייקטים הבאים:

  • signedinUser יכול להיות:

    • אדם שמצטרף ממחשב אישי, ממכשיר נייד או באמצעות מצב Companion.

    • חשבון רובוט שמשמש מכשירים בחדרי ישיבות.

  • anonymousUser הוא משתמש לא מזוהה שלא מחובר לחשבון Google.

  • phoneUser הוא משתמש שמצטרף לשיחה מהטלפון, והזהות שלו לא ידועה כי הוא לא נכנס לחשבון Google.

שימו לב: כל שלושת האובייקטים מחזירים displayName, אבל signedinUser מחזיר גם מזהה user ייחודי שאפשר להשתמש בו עם SDK לאדמינים ועם People API. פורמט: users/{user} מידע נוסף על שימוש במזהה user עם People API זמין במאמר אחזור פרטי משתתפים באמצעות People API.

איך רואים פרטים על משתתף

כדי לקבל פרטים על משתתף ספציפי, משתמשים בשיטה get במשאב participants. מגדירים את פרמטר הנתיב name באמצעות הפורמט conferenceRecords/{conferenceRecord}/participants/{participantRecord}.

אם אתם לא יודעים את שם המשתתף, אתם יכולים לרשום את כל שמות המשתתפים באמצעות השיטה list.

השיטה מחזירה נתוני משתתפים כמופע של משאב participants.

בדוגמת הקוד הבאה אפשר לראות איך מאחזרים משתתף ספציפי:

Java

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 באסימון הגישה שמעניק גישה ל-API.

מחליפים את מה שכתוב בשדות הבאים:

  • שם מאזן השיחות עם השם של מזהה שיחה ספציפי במאזן השיחות.
  • שם המשתתף עם השם של מזהה המשתתף הספציפי ברשומה של שיחת ועידה.

הצגת רשימה של כל המשתתפים

כדי לראות את הפרטים של כל המשתתפים בהקלטה של שיחת ועידה, משתמשים בשיטה list במשאב participants. מגדירים את פרמטר הנתיב parent באמצעות הפורמט conferenceRecords/{conferenceRecord}.

השיטה מחזירה רשימה של משתתפים בוועידה, מסודרת לפי earliestStartTime בסדר יורד, כמופע של משאב participants. כדי לשנות את גודל הדף ולסנן את תוצאות השאילתה, אפשר לעיין במאמר בנושא התאמה אישית של מספור הדפים או סינון רשימת המשתתפים.

בדוגמת הקוד הבאה אפשר לראות איך מציגים רשימה של כל המשתתפים בהקלטה של שיחת ועידה:

Java

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 באסימון הגישה שמעניק גישה ל-API.

מחליפים את שם ההורה בשם של מזהה הוועידה הספציפי ברשומה של הוועידה.

התאמה אישית של חלוקה לדפים או סינון של רשימת המשתתפים

מעבירים את הפרמטרים הבאים של השאילתה כדי להתאים אישית את המספור של המשתתפים או לסנן אותם:

  • pageSize: המספר המקסימלי של המשתתפים שיוחזרו. יכול להיות שהשירות יחזיר פחות מהערך הזה. אם לא מציינים ערך, ה-API יחזיר עד 100 משתתפים. הערך המקסימלי הוא 250. ערכים שגדולים מ-250 משתנים אוטומטית ל-250.

  • pageToken: טוקן של דף שהתקבל מקריאה קודמת של list. צריך להזין את הטוקן הזה כדי לאחזר את הדף הבא.

  • 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, המזהה של 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: אסימון הגישה שמעניק גישה לכמה ממשקי API.

סשנים של משתתפים

בקטעים הבאים מוסבר איך לקבל מידע על סשנים של משתתפים בהקלטה של שיחת ועידה.

איך רואים פרטים על סשן של משתתף

כדי לקבל פרטים על סשן של משתתף ספציפי, משתמשים בשיטה get במשאב participantSessions. מגדירים את פרמטר הנתיב name באמצעות הפורמט conferenceRecords/{conferenceRecord}/participants/{participantRecord}/participantSessions/{participantSessionRecord}.

אם אתם לא יודעים את שם הסשן של המשתתף, אתם יכולים לרשום את כל הסשנים של המשתתף באמצעות השיטה list.

השיטה מחזירה סשן של משתתף כמופע של משאב participantSessions.

בדוגמת הקוד הבאה אפשר לראות איך מאחזרים סשן ספציפי של משתתף:

Java

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 באסימון הגישה שמעניק גישה ל-API.

מחליפים את מה שכתוב בשדות הבאים:

  • שם מאזן השיחות עם השם של מזהה שיחה ספציפי במאזן השיחות.
  • שם המשתתף עם השם של מזהה המשתתף הספציפי ברשומה של שיחת ועידה.
  • מזהה הסשן של המשתתף עם המזהה של הסשן הספציפי של המשתתף.

הצגת רשימה של כל הסשנים של המשתתפים

כדי לראות את הפרטים של כל סשן של משתתף בהקלטה של שיחת ועידה, משתמשים בשיטה list במשאב participantSessions. מגדירים את פרמטר הנתיב parent באמצעות הפורמט conferenceRecords/{conferenceRecord}/participants/{participantRecord}.

השיטה מחזירה רשימה של סשנים של משתתפים, מסודרים לפי startTime בסדר יורד, כמופע של משאב participantSession. כדי לשנות את גודל הדף ולסנן את תוצאות השאילתה, אפשר לעיין במאמר בנושא התאמה אישית של חלוקה לדפים או סינון של רשימת הסשנים של המשתתפים.

בדוגמת הקוד הבאה מוצג איך אפשר להציג רשימה של כל הסשנים של המשתתפים ברשומה של שיחת ועידה:

Java

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
/**
 * 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();

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/PARTICIPANT_NAME/participantSessions" \
  -H "Authorization: Bearer ACCESS_TOKEN"

מחליפים את ACCESS_TOKEN באסימון הגישה שמעניק גישה ל-API.

מחליפים את מה שכתוב בשדות הבאים:

  • שם מאזן השיחות עם השם של מזהה שיחה ספציפי במאזן השיחות.
  • שם המשתתף עם השם של מזהה המשתתף הספציפי ברשומה של שיחת ועידה.

התאמה אישית של המספור או סינון של רשימת הסשנים של המשתתפים

אפשר להעביר את הפרמטרים האופציונליים הבאים של השאילתה כדי להתאים אישית את המספור של הדפים או לסנן את הסשנים של המשתתפים:

  • pageSize: המספר המקסימלי של סשנים של משתתפים שיוחזרו. יכול להיות שהשירות יחזיר פחות מהערך הזה. אם לא מציינים ערך, יוחזרו לכל היותר 100 סשנים של משתתפים. הערך המקסימלי הוא 250. ערכים גבוהים מ-250 משתנים אוטומטית ל-250.

  • pageToken: טוקן של דף שהתקבל מקריאה קודמת של list. צריך להזין את הטוקן הזה כדי לאחזר את הדף הבא.

  • filter: אופציונלי. מסנן שאילתה לאחזור פריטים ספציפיים בתוצאות של משאב participantSessions.

    אפשר להשתמש בשדות 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.