با کنفرانس ها کار کنید

این راهنما نحوه دریافت جزئیات مربوط به یک کنفرانس یا همه کنفرانس‌ها را در منبع conferenceRecords از API REST گوگل میت توضیح می‌دهد.

یک کنفرانس، نمونه‌ای از یک تماس تلفنی تولید شده توسط سرور در یک فضای جلسه است. همچنین می‌توان آن را نمونه‌ای واحد از یک جلسه نیز دانست.

اگر شما صاحب یا شرکت‌کننده‌ی فضای جلسه هستید، می‌توانید متدهای get() و list() را برای بازیابی رکوردهای کنفرانس فراخوانی کنید.

احراز هویت و مجوزدهی با استفاده از اعتبارنامه‌های کاربر به برنامه‌های Google Meet اجازه می‌دهد تا به داده‌های کاربر دسترسی پیدا کرده و عملیات را از طرف کاربر احراز هویت‌شده انجام دهند. احراز هویت با واگذاری اختیارات در سطح دامنه به شما امکان می‌دهد تا حساب سرویس یک برنامه را برای دسترسی به داده‌های کاربران خود بدون نیاز به رضایت هر کاربر، مجاز کنید.

دریافت جزئیات مربوط به یک کنفرانس

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

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

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

جاوا

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();
    }
  }
}

نود جی اس

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

پایتون

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-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);
      }
    }
  }
}

نود جی اس

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

پایتون

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 : حداکثر تعداد رکوردهای کنفرانس برای برگرداندن. سرویس ممکن است کمتر از این مقدار را برگرداند. اگر مشخص نشود، حداکثر ۲۵ رکورد کنفرانس برگردانده می‌شود. حداکثر مقدار ۱۰۰ است؛ مقادیر بیش از ۱۰۰ به طور خودکار به ۱۰۰ تغییر می‌کنند.

  • pageToken : یک توکن صفحه که از فراخوانی لیست قبلی دریافت شده است. این توکن را برای بازیابی صفحه بعدی ارائه دهید.

  • filter : یک فیلتر پرس‌وجو برای بازیابی موارد خاص در نتایج منبع conferenceRecords . برای جزئیات پرس‌وجوی پشتیبانی‌شده، به متد list() مراجعه کنید. برای اطلاعات بیشتر در مورد نحوه تعیین فضای جلسه، به نحوه شناسایی فضای جلسه توسط Meet مراجعه کنید.