עבודה עם שיחות ועידה

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

שיחת ועידה היא מופע שנוצר בשרת של שיחה במרחב פגישות. היא יכולה להיות גם מופע יחיד של פגישה.

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

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

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

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

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

השיטה מחזירה ועידה קודמת כמופע של המשאב conferenceRecords.

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

Java

java-meet/samples/snippets/generated/com/google/apps/meet/v2/conferencerecordsservice/getconferencerecord/AsyncGetConferenceRecord.java

הצגת הקוד ב-GitHub

import com.google.api.core.ApiFuture;
import com.google.apps.meet.v2.ConferenceRecord;
import com.google.apps.meet.v2.ConferenceRecordName;
import com.google.apps.meet.v2.ConferenceRecordsServiceClient;
import com.google.apps.meet.v2.GetConferenceRecordRequest;

public class AsyncGetConferenceRecord {

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

  public static void asyncGetConferenceRecord() 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()) {
      GetConferenceRecordRequest request =
          GetConferenceRecordRequest.newBuilder()
              .setName(ConferenceRecordName.of("[CONFERENCE_RECORD]").toString())
              .build();
      ApiFuture<ConferenceRecord> future =
          conferenceRecordsServiceClient.getConferenceRecordCallable().futureCall(request);
      // Do something.
      ConferenceRecord response = future.get();
    }
  }
}

Node.js

packages/google-apps-meet/samples/generated/v2/conference_records_service.get_conference_record.js

הצגת הקוד ב-GitHub

/**
 * 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 conference.
 */
// const name = 'abc123'

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

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

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

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

callGetConferenceRecord();

Python

packages/google-apps-meet/samples/generated_samples/meet_v2_generated_conference_records_service_get_conference_record_async.py

הצגת הקוד ב-GitHub

# 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_conference_record():
    # Create a client
    client = meet_v2.ConferenceRecordsServiceAsyncClient()

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

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

    # Handle the response
    print(response)

cURL

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

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

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

הצגת רשימה של כל שיחות הוועידה

כדי להציג רשימה של פרטים על כל הכנסים, משתמשים ב-method ‏list במשאב conferenceRecords בלי פרמטרים של נתיב.

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

הערה: השיטה list מחזירה רק פגישות שאתם המארגנים שלהן. אם לאפליקציה שבה אתם משתמשים כדי לצפות בשיחות ועידה יש רק את היקף OAuth‏ meetings.space.created, תוכלו לצפות רק בשיחות ועידה במרחבים שהאפליקציה יצרה. מידע נוסף זמין במאמר היקפי הגישה של Meet API בארכיטקטורת REST.

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

Java

java-meet/samples/snippets/generated/com/google/apps/meet/v2/conferencerecordsservice/listconferencerecords/AsyncListConferenceRecords.java

הצגת הקוד ב-GitHub

import com.google.api.core.ApiFuture;
import com.google.apps.meet.v2.ConferenceRecord;
import com.google.apps.meet.v2.ConferenceRecordsServiceClient;
import com.google.apps.meet.v2.ListConferenceRecordsRequest;

public class AsyncListConferenceRecords {

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

  public static void asyncListConferenceRecords() 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()) {
      ListConferenceRecordsRequest request =
          ListConferenceRecordsRequest.newBuilder()
              .setPageSize(883849137)
              .setPageToken("pageToken873572522")
              .setFilter("filter-1274492040")
              .build();
      ApiFuture<ConferenceRecord> future =
          conferenceRecordsServiceClient.listConferenceRecordsPagedCallable().futureCall(request);
      // Do something.
      for (ConferenceRecord element : future.get().iterateAll()) {
        // doThingsWith(element);
      }
    }
  }
}

Node.js

packages/google-apps-meet/samples/generated/v2/conference_records_service.list_conference_records.js

הצגת הקוד ב-GitHub

/**
 * 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.
 */
/**
 *  Optional. Maximum number of conference records to return. The service might
 *  return fewer than this value. If unspecified, at most 25 conference records
 *  are returned. The maximum value is 100; values above 100 are coerced to
 *  100. 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:
 *  * `space.meeting_code`
 *  * `space.name`
 *  * `start_time`
 *  * `end_time`
 *  For example, consider the following filters:
 *  * `space.name = "spaces/NAME"`
 *  * `space.meeting_code = "abc-mnop-xyz"`
 *  * `start_time>="2024-01-01T00:00:00.000Z" AND
 *  start_time<="2024-01-02T00:00:00.000Z"`
 *  * `end_time IS NULL`
 */
// const filter = 'abc123'

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

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

async function callListConferenceRecords() {
  // Construct request
  const request = {
  };

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

callListConferenceRecords();

Python

packages/google-apps-meet/samples/generated_samples/meet_v2_generated_conference_records_service_list_conference_records_async.py

הצגת הקוד ב-GitHub

# 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_conference_records():
    # Create a client
    client = meet_v2.ConferenceRecordsServiceAsyncClient()

    # Initialize request argument(s)
    request = meet_v2.ListConferenceRecordsRequest()

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

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

cURL

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

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

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

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

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

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

• ‫filter: מסנן שאילתות לאחזור פריטים ספציפיים בתוצאות של משאב conferenceRecords. פרטים על שאילתות נתמכות מופיעים בשיטה list. מידע נוסף על קביעת מרחב לפגישה זמין במאמר איך Meet מזהה מרחב לפגישה.