العمل مع المؤتمرات

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

المؤتمر هو نسخة من مكالمة ينشئها الخادم ضمن مساحة اجتماع. وهو أيضًا مثال واحد على اجتماع.

إذا كنت مالكًا لمساحة اجتماع أو مشاركًا فيها، يمكنك استخدام الطريقتَين get() وlist() لاسترداد سجلّات المؤتمرات.

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

الحصول على تفاصيل حول مؤتمر

للحصول على تفاصيل حول اجتماع معيّن، استخدِم طريقة get() في مورد conferenceRecords مع مَعلمة المسار name الخاصة بالاجتماع. إذا كنت لا تعرف اسم الاجتماع، يمكنك إدراج جميع أسماء الاجتماعات باستخدام طريقة list().

تعرض الطريقة مؤتمرًا سابقًا كمثيل للمورد conferenceRecords.

يوضّح نموذج الرمز البرمجي التالي كيفية استرداد اجتماع محدّد:

Java

java-meet/samples/snippets/generated/com/google/apps/meet/v2/conferencerecordsservice/getconferencerecord/AsyncGetConferenceRecord.java
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
/**
 * 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
# 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)

استبدِل اسم سجلّ مكالمة الفيديو باسم رقم تعريف مكالمة الفيديو المحدّد في سجلّ مكالمة الفيديو.

عرض قائمة بجميع المؤتمرات

لعرض تفاصيل حول جميع المؤتمرات، استخدِم طريقة list() في المورد conferenceRecords بدون أي مَعلمات مسار.

تعرض الطريقة قائمة بالمؤتمرات السابقة كنموذج من المورد conferenceRecords. يتم فلترتها لتظهر لمنظّم المؤتمر، ويتم ترتيبها حسب startTime بترتيب تنازلي. لضبط حجم الصفحة وفلترة نتائج طلب البحث، اطّلِع على تخصيص تقسيم الصفحات أو فلترة القائمة.

يوضّح نموذج الرمز البرمجي التالي كيفية إدراج جميع المؤتمرات:

Java

java-meet/samples/snippets/generated/com/google/apps/meet/v2/conferencerecordsservice/listconferencerecords/AsyncListConferenceRecords.java
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
/**
 * 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
# 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)

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

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

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

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

  • filter: فلتر طلب بحث لاسترداد عناصر معيّنة في نتائج المورد conferenceRecords. للاطّلاع على تفاصيل طلبات البحث المتوافقة، يُرجى الاطّلاع على طريقة list(). لمزيد من المعلومات حول كيفية تحديد مساحة اجتماع، يُرجى الاطّلاع على كيفية تحديد مساحة اجتماع في Meet.