استخدام العناصر

يوضّح هذا المستند كيفية الحصول على تفاصيل حول عناصر اجتماع مختلفة تم إنشاؤها من خلال مؤتمر باستخدام Google Meet REST API.

الناتج هو ملف أو بيانات تنشئها Google Meet استجابةً لاجتماع. ويشمل ذلك تسجيلات الفيديو وغيرها من البيانات، مثل النصوص.

لإنشاء بيانات الاجتماع، على المشاركين ضبطها في Meet قبل انتهاء المؤتمر. لمزيد من المعلومات، يُرجى الاطّلاع على إدارة العناصر التلقائية.

تعمل النصوص بشكل مستقل عن التسجيلات، ولست بحاجة إلى تسجيل الاجتماع لإنشاء نص. عندما يغادر جميع المشاركين الاجتماع، يتم إيقاف ميزة "النصوص" تلقائيًا. لمزيد من المعلومات، يُرجى الاطّلاع على تسجيل اجتماع فيديو واستخدام النصوص مع Google Meet.

استرداد البيانات

إذا كنت مالكًا لمساحة اجتماع أو مشاركًا فيها، يمكنك استدعاء الطريقتَين get وlist في الموارد recordings وtranscripts وtranscripts.entries وsmart notes لاسترداد العناصر. لمزيد من المعلومات، راجِع الأقسام التالية.

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

الاحتفاظ بالنتائج

بعد انتهاء مؤتمر، يحفظ Meet التسجيلات والنصوص في Google Drive الخاص بمنظِّم الاجتماع. يتم تلقائيًا الاحتفاظ ببيانات Meet وفقًا لقواعد Drive.

يتم حذف إدخالات النصوص التي يوفّرها Meet REST API بعد 30 يومًا من انتهاء الاجتماع.

يمكنك أيضًا إدارة الاحتفاظ ببيانات الاجتماع من Meet بشكل منفصل باستخدام قواعد الاحتفاظ بالبيانات الخاصة بتطبيق Meet في Google Vault. لمزيد من المعلومات، يُرجى الاطّلاع على الاحتفاظ ببيانات Google Meet باستخدام Vault.

التسجيلات

توضّح الأقسام التالية كيفية الحصول على معلومات حول التسجيلات في سجلّ مؤتمر.

يتمكّن Meet من الوصول إلى معرّف التسجيل بعد إنشاء ملف التسجيل. من المحتمل أن يحذف المستخدم ملف التسجيل من Google Drive، ولكن سيظل الاسم الفريد يظهر في Meet.

يتضمّن المرجع recordings كلاً من الكائنَين DriveDestination وState.

يحتوي العنصر DriveDestination على موقع التصدير في Drive حيث يتم حفظ التسجيل كملف MP4. لتنزيل التسجيل أو تشغيله في المتصفّح، استخدِم قيمة الحقل exportUri الخاص بالكائن. إذا كنت على دراية بواجهة Google Drive API، فإنّ قيمة الحقل file تتطابق مع الحقل id في المورد files. لمزيد من المعلومات، يُرجى الاطّلاع على تنزيل الملفات وتصديرها.

يحتوي العنصر State على حالة جلسة التسجيل. يتيح لك ذلك الاستعلام عمّا إذا بدأ التسجيل، أو إذا انتهى التسجيل ولكن ملف التسجيل غير جاهز، أو إذا تم إنشاء ملف التسجيل وأصبح جاهزًا للتنزيل.

الحصول على تفاصيل حول تسجيل

للحصول على تفاصيل حول تسجيل معيّن، استخدِم طريقة get في المورد recordings. اضبط مَعلمة المسار name باستخدام التنسيق conferenceRecords/{conferenceRecord}/recordings/{recordingName}.

إذا كنت لا تعرف اسم التسجيل، يمكنك إدراج جميع أسماء التسجيلات باستخدام طريقة list.

تعرض الطريقة مثيلاً لمورد recordings.

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

جافا

java-meet/samples/snippets/generated/com/google/apps/meet/v2/conferencerecordsservice/getrecording/AsyncGetRecording.java
import com.google.api.core.ApiFuture;
import com.google.apps.meet.v2.ConferenceRecordsServiceClient;
import com.google.apps.meet.v2.GetRecordingRequest;
import com.google.apps.meet.v2.Recording;
import com.google.apps.meet.v2.RecordingName;

public class AsyncGetRecording {

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

  public static void asyncGetRecording() 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()) {
      GetRecordingRequest request =
          GetRecordingRequest.newBuilder()
              .setName(RecordingName.of("[CONFERENCE_RECORD]", "[RECORDING]").toString())
              .build();
      ApiFuture<Recording> future =
          conferenceRecordsServiceClient.getRecordingCallable().futureCall(request);
      // Do something.
      Recording response = future.get();
    }
  }
}

Node.js

packages/google-apps-meet/samples/generated/v2/conference_records_service.get_recording.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 recording.
 */
// const name = 'abc123'

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

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

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

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

callGetRecording();

Python

packages/google-apps-meet/samples/generated_samples/meet_v2_generated_conference_records_service_get_recording_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_recording():
    # Create a client
    client = meet_v2.ConferenceRecordsServiceAsyncClient()

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

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

    # Handle the response
    print(response)

cURL

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

استبدِل ACCESS_TOKEN برمز الدخول الذي يمنح إذن الوصول إلى واجهة برمجة التطبيقات.

غيِّر القيم في السلسلة على الشكل التالي:

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

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

لعرض تفاصيل حول جميع التسجيلات في سجلّ مؤتمرات، استخدِم طريقة list في المورد recordings. اضبط مَعلمة المسار parent باستخدام التنسيق conferenceRecords/{conferenceRecord}.

تعرض الطريقة قائمة بتسجيلات المؤتمرات، مرتّبة حسب startTime بترتيب تصاعدي، كنموذج لمورد recordings. لضبط حجم الصفحة، يُرجى الاطّلاع على تخصيص تقسيم المحتوى إلى صفحات .

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

جافا

java-meet/samples/snippets/generated/com/google/apps/meet/v2/conferencerecordsservice/listrecordings/AsyncListRecordings.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.ListRecordingsRequest;
import com.google.apps.meet.v2.Recording;

public class AsyncListRecordings {

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

  public static void asyncListRecordings() 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()) {
      ListRecordingsRequest request =
          ListRecordingsRequest.newBuilder()
              .setParent(ConferenceRecordName.of("[CONFERENCE_RECORD]").toString())
              .setPageSize(883849137)
              .setPageToken("pageToken873572522")
              .build();
      ApiFuture<Recording> future =
          conferenceRecordsServiceClient.listRecordingsPagedCallable().futureCall(request);
      // Do something.
      for (Recording element : future.get().iterateAll()) {
        // doThingsWith(element);
      }
    }
  }
}

Node.js

packages/google-apps-meet/samples/generated/v2/conference_records_service.list_recordings.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 recordings to return. The service might return fewer
 *  than this value.
 *  If unspecified, at most 10 recordings are returned.
 *  The maximum value is 100; values above 100 are coerced to 100.
 *  Maximum might change in the future.
 */
// const pageSize = 1234
/**
 *  Page token returned from previous List Call.
 */
// const pageToken = 'abc123'

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

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

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

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

callListRecordings();

Python

packages/google-apps-meet/samples/generated_samples/meet_v2_generated_conference_records_service_list_recordings_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_recordings():
    # Create a client
    client = meet_v2.ConferenceRecordsServiceAsyncClient()

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

    # Make the request
    page_result = client.list_recordings(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/recordings" \
-H "Authorization: Bearer ACCESS_TOKEN"

استبدِل ACCESS_TOKEN برمز الدخول الذي يمنح إذن الوصول إلى واجهة برمجة التطبيقات.

استبدِل اسم العنصر الرئيسي باسم معرّف المؤتمر المحدّد في سجلّ المؤتمر.

الصوت المحوَّل إلى نص

توضّح الأقسام التالية كيفية الحصول على معلومات حول نصوص الاجتماعات في سجلّ اجتماع.

يملك Meet إذن الوصول إلى معرّف النص بعد إنشاء بيانات النص. من المحتمل أن يحذف المستخدم ملف النص من Drive، ولكن سيظل الاسم الفريد يظهر في Meet.

يتضمّن المرجع transcripts كلاً من الكائنَين DocsDestination وState.

يحتوي العنصر DocsDestination على موقع التصدير في Drive حيث يتم حفظ ملف نص الفيديو في "مستندات Google". لاسترداد المحتوى أو تصفّح نص الفيديو في متصفّح، استخدِم قيمة الحقل exportUri الخاص بالكائن. إذا كنت على دراية بواجهة Google Docs API، تتوافق قيمة الحقل document مع documentId في المرجع documents.

يحتوي العنصر State على حالة جلسة تحويل الصوت إلى نص. يتيح لك ذلك الاستعلام عمّا إذا كانت جلسة النص قد بدأت، أو إذا كانت قد انتهت ولكن ملف النص غير جاهز، أو إذا تم إنشاء ملف النص وأصبح جاهزًا للتنزيل.

الحصول على تفاصيل حول نص

للحصول على تفاصيل حول نص معيّن، استخدِم طريقة get في المورد transcripts. اضبط مَعلمة المسار name باستخدام التنسيق conferenceRecords/{conferenceRecord}/transcripts/{transcriptName}.

إذا كنت لا تعرف اسم النص، يمكنك إدراج جميع أسماء النصوص باستخدام طريقة list.

تعرض الطريقة مثيلاً لمورد transcripts.

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

جافا

java-meet/samples/snippets/generated/com/google/apps/meet/v2/conferencerecordsservice/gettranscript/AsyncGetTranscript.java
import com.google.api.core.ApiFuture;
import com.google.apps.meet.v2.ConferenceRecordsServiceClient;
import com.google.apps.meet.v2.GetTranscriptRequest;
import com.google.apps.meet.v2.Transcript;
import com.google.apps.meet.v2.TranscriptName;

public class AsyncGetTranscript {

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

  public static void asyncGetTranscript() 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()) {
      GetTranscriptRequest request =
          GetTranscriptRequest.newBuilder()
              .setName(TranscriptName.of("[CONFERENCE_RECORD]", "[TRANSCRIPT]").toString())
              .build();
      ApiFuture<Transcript> future =
          conferenceRecordsServiceClient.getTranscriptCallable().futureCall(request);
      // Do something.
      Transcript response = future.get();
    }
  }
}

Node.js

packages/google-apps-meet/samples/generated/v2/conference_records_service.get_transcript.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 transcript.
 */
// const name = 'abc123'

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

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

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

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

callGetTranscript();

Python

packages/google-apps-meet/samples/generated_samples/meet_v2_generated_conference_records_service_get_transcript_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_transcript():
    # Create a client
    client = meet_v2.ConferenceRecordsServiceAsyncClient()

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

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

    # Handle the response
    print(response)

cURL

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

استبدِل ACCESS_TOKEN برمز الدخول الذي يمنح إذن الوصول إلى واجهة برمجة التطبيقات.

غيِّر القيم في السلسلة على الشكل التالي:

  • اسم سجلّ مكالمة الفيديو مع اسم رقم تعريف مكالمة الفيديو المحدّد في سجلّ مكالمة فيديو
  • اسم نص الاجتماع مع اسم معرّف نص الاجتماع المحدّد في سجلّ اجتماع

عرض قائمة بجميع النصوص

لعرض تفاصيل حول جميع النصوص في سجلّ مؤتمر، استخدِم طريقة list في مورد transcripts. اضبط مَعلمة المسار parent باستخدام التنسيق conferenceRecords/{conferenceRecord}.

تعرض الطريقة قائمة بنصوص المؤتمرات، مرتّبة حسب startTime بترتيب تصاعدي، كنموذج لمورد transcripts. لضبط حجم الصفحة، يُرجى الاطّلاع على تخصيص تقسيم المحتوى إلى صفحات .

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

جافا

java-meet/samples/snippets/generated/com/google/apps/meet/v2/conferencerecordsservice/listtranscripts/AsyncListTranscripts.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.ListTranscriptsRequest;
import com.google.apps.meet.v2.Transcript;

public class AsyncListTranscripts {

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

  public static void asyncListTranscripts() 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()) {
      ListTranscriptsRequest request =
          ListTranscriptsRequest.newBuilder()
              .setParent(ConferenceRecordName.of("[CONFERENCE_RECORD]").toString())
              .setPageSize(883849137)
              .setPageToken("pageToken873572522")
              .build();
      ApiFuture<Transcript> future =
          conferenceRecordsServiceClient.listTranscriptsPagedCallable().futureCall(request);
      // Do something.
      for (Transcript element : future.get().iterateAll()) {
        // doThingsWith(element);
      }
    }
  }
}

Node.js

packages/google-apps-meet/samples/generated/v2/conference_records_service.list_transcripts.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 transcripts to return. The service might return fewer
 *  than this value.
 *  If unspecified, at most 10 transcripts are returned.
 *  The maximum value is 100; values above 100 are coerced to 100.
 *  Maximum might change in the future.
 */
// const pageSize = 1234
/**
 *  Page token returned from previous List Call.
 */
// const pageToken = 'abc123'

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

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

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

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

callListTranscripts();

Python

packages/google-apps-meet/samples/generated_samples/meet_v2_generated_conference_records_service_list_transcripts_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_transcripts():
    # Create a client
    client = meet_v2.ConferenceRecordsServiceAsyncClient()

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

    # Make the request
    page_result = client.list_transcripts(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/transcripts" \
-H "Authorization: Bearer ACCESS_TOKEN"

استبدِل ACCESS_TOKEN برمز الدخول الذي يمنح إذن الوصول إلى واجهة برمجة التطبيقات.

استبدِل اسم العنصر الرئيسي باسم معرّف المؤتمر المحدّد في سجلّ المؤتمر.

إدخالات النص

توضّح الأقسام التالية كيفية الحصول على نص لكل مشارك خلال جلسة تسجيل نصية لمكالمة جماعية.

يتضمّن إدخال نص المحادثة نصًا مكتوبًا لصوت المشارك، يصل إلى 10,000 كلمة كحد أقصى. يتم أيضًا تضمين النص المنطوق languageCode (مثلاً، en-US) كـ بنية IETF BCP 47.

يرتبط كل إدخال في نص الاجتماع participant باسم في الاجتماع. لاسترداد تفاصيل المشاركين، راجِع الحصول على تفاصيل حول أحد المشاركين.

تتوفّر بيانات إدخال نص الاجتماع لمدة 30 يومًا بعد انتهاء المؤتمر.

يُرجى العِلم أنّ إدخالات نص الاجتماع التي تعرضها واجهة برمجة تطبيقات Meet REST قد لا تتطابق مع نص الاجتماع في ملف نص الاجتماع في "مستندات Google". يحدث ذلك عند تعديل ملف نص الفيديو بعد إنشائه.

الحصول على تفاصيل حول إدخال في نص

للحصول على تفاصيل حول إدخال معيّن في نص الفيديو، استخدِم طريقة get في المورد transcripts.entries. اضبط مَعلمة المسار name باستخدام التنسيق conferenceRecords/{conferenceRecord}/transcripts/{transcriptName}/entries/{transcriptEntryName}.

إذا كنت لا تعرف اسم إدخال النص، يمكنك إدراج جميع أسماء إدخالات النص باستخدام طريقة list.

تعرض الطريقة مثيلاً لمورد transcripts.entries.

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

جافا

java-meet/samples/snippets/generated/com/google/apps/meet/v2/conferencerecordsservice/gettranscriptentry/AsyncGetTranscriptEntry.java
import com.google.api.core.ApiFuture;
import com.google.apps.meet.v2.ConferenceRecordsServiceClient;
import com.google.apps.meet.v2.GetTranscriptEntryRequest;
import com.google.apps.meet.v2.TranscriptEntry;
import com.google.apps.meet.v2.TranscriptEntryName;

public class AsyncGetTranscriptEntry {

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

  public static void asyncGetTranscriptEntry() 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()) {
      GetTranscriptEntryRequest request =
          GetTranscriptEntryRequest.newBuilder()
              .setName(
                  TranscriptEntryName.of("[CONFERENCE_RECORD]", "[TRANSCRIPT]", "[ENTRY]")
                      .toString())
              .build();
      ApiFuture<TranscriptEntry> future =
          conferenceRecordsServiceClient.getTranscriptEntryCallable().futureCall(request);
      // Do something.
      TranscriptEntry response = future.get();
    }
  }
}

Node.js

packages/google-apps-meet/samples/generated/v2/conference_records_service.get_transcript_entry.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 `TranscriptEntry`.
 */
// const name = 'abc123'

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

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

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

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

callGetTranscriptEntry();

Python

packages/google-apps-meet/samples/generated_samples/meet_v2_generated_conference_records_service_get_transcript_entry_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_transcript_entry():
    # Create a client
    client = meet_v2.ConferenceRecordsServiceAsyncClient()

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

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

    # Handle the response
    print(response)

cURL

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

استبدِل ACCESS_TOKEN برمز الدخول الذي يمنح إذن الوصول إلى واجهة برمجة التطبيقات.

غيِّر القيم في السلسلة على الشكل التالي:

  • اسم سجلّ مكالمة الفيديو مع اسم رقم تعريف مكالمة الفيديو المحدّد في سجلّ مكالمة فيديو
  • اسم نص الاجتماع مع اسم معرّف نص الاجتماع المحدّد في سجلّ الاجتماع
  • اسم إدخال نص الفيديو مع اسم معرّف إدخال نص الفيديو المحدّد في نص الفيديو

عرض جميع إدخالات النص

لعرض تفاصيل عن جميع إدخالات النص في نسخة طبق الأصل، استخدِم طريقة list في المورد transcripts.entries. اضبط مَعلمة المسار parent باستخدام التنسيق conferenceRecords/{conferenceRecord}/transcripts/{transcript}.

تعرض الطريقة قائمة بإدخالات نصية منظَّمة لكل نص اجتماع، مرتّبة حسب startTime بترتيب تصاعدي، كنموذج من مورد transcripts.entries. لتعديل حجم الصفحة، يُرجى الاطّلاع على تخصيص تقسيم المحتوى إلى صفحات .

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

جافا

java-meet/samples/snippets/generated/com/google/apps/meet/v2/conferencerecordsservice/listtranscriptentries/AsyncListTranscriptEntries.java
import com.google.api.core.ApiFuture;
import com.google.apps.meet.v2.ConferenceRecordsServiceClient;
import com.google.apps.meet.v2.ListTranscriptEntriesRequest;
import com.google.apps.meet.v2.TranscriptEntry;
import com.google.apps.meet.v2.TranscriptName;

public class AsyncListTranscriptEntries {

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

  public static void asyncListTranscriptEntries() 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()) {
      ListTranscriptEntriesRequest request =
          ListTranscriptEntriesRequest.newBuilder()
              .setParent(TranscriptName.of("[CONFERENCE_RECORD]", "[TRANSCRIPT]").toString())
              .setPageSize(883849137)
              .setPageToken("pageToken873572522")
              .build();
      ApiFuture<TranscriptEntry> future =
          conferenceRecordsServiceClient.listTranscriptEntriesPagedCallable().futureCall(request);
      // Do something.
      for (TranscriptEntry element : future.get().iterateAll()) {
        // doThingsWith(element);
      }
    }
  }
}

Node.js

packages/google-apps-meet/samples/generated/v2/conference_records_service.list_transcript_entries.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}/transcripts/{transcript}`
 */
// const parent = 'abc123'
/**
 *  Maximum number of entries to return. The service might return fewer than
 *  this value.
 *  If unspecified, at most 10 entries are returned.
 *  The maximum value is 100; values above 100 are coerced to 100.
 *  Maximum might change in the future.
 */
// const pageSize = 1234
/**
 *  Page token returned from previous List Call.
 */
// const pageToken = 'abc123'

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

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

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

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

callListTranscriptEntries();

Python

packages/google-apps-meet/samples/generated_samples/meet_v2_generated_conference_records_service_list_transcript_entries_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_transcript_entries():
    # Create a client
    client = meet_v2.ConferenceRecordsServiceAsyncClient()

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

    # Make the request
    page_result = client.list_transcript_entries(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/transcripts/TRANSCRIPT_NAME/entries" \
-H "Authorization: Bearer ACCESS_TOKEN"

استبدِل ACCESS_TOKEN برمز الدخول الذي يمنح إذن الوصول إلى واجهة برمجة التطبيقات.

غيِّر القيم في السلسلة على الشكل التالي:

  • اسم العنصر الرئيسي مع اسم رقم تعريف مكالمة الفيديو المحدّد في سجلّ مكالمة فيديو
  • اسم نص الاجتماع مع اسم معرّف نص الاجتماع المحدّد في سجلّ الاجتماع

الملاحظات الذكية

توضّح الأقسام التالية بالتفصيل كيفية الحصول على معلومات حول الملاحظات الذكية في مكالمة فيديو ضمن سجلّ مكالمة فيديو.

يتمكّن Meet من الوصول إلى معرّف الملاحظة الذكية بعد إنشاء بيانات الملاحظة الذكية. من المحتمل أن يحذف المستخدم ملف الملاحظات الذكية من Drive، ولكن سيظل الاسم الفريد يظهر في Meet.

يتضمّن المرجع smartNotes الكائن State. يحتوي هذا العنصر على حالة جلسة الملاحظات الذكية. يتيح لك ذلك الاستعلام عمّا إذا كانت جلسة "الملاحظات الذكية" قد بدأت، أو إذا كانت قد انتهت ولكن ملف "الملاحظات الذكية" غير جاهز، أو إذا تم إنشاء ملف "الملاحظات الذكية" وأصبح جاهزًا للتنزيل.

يتضمّن المرجع smartNotes أيضًا نوع العنصر DocsDestination. يحتوي هذا العنصر على موقع التصدير في Drive حيث يتم حفظ ملف الملاحظات الذكية في &quot;مستندات Google&quot;. لاسترداد المحتوى أو تصفّح الملاحظات الذكية في متصفّح، استخدِم قيمة الحقل exportUri الخاص بالكائن. إذا كنت على دراية بواجهة Google Docs API، يتوافق قيمة الحقل document مع documentId في المرجع documents.

يمكنك إدارة الملاحظات الذكية باستخدام الطريقتَين get وlist.

.

الحصول على تفاصيل حول "الملخّصات الذكية"

للحصول على تفاصيل حول ملف ملاحظات ذكية معيّن، استخدِم طريقة get في smartNotes. اضبط مَعلمة المسار name باستخدام التنسيق conferenceRecords/{conferenceRecord}/smartNotes/{smartNote}.

إذا كنت لا تعرف اسم الملاحظات الذكية، يمكنك إدراج جميع ملفات الملاحظات الذكية باستخدام طريقة list.

تعرض الطريقة مثيلاً لمورد smartNotes.

cURL

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

غيِّر القيم في السلسلة على الشكل التالي:

  • CONFERENCE_RECORD_NAME: رقم تعريف مكالمة الفيديو المحدّد في سجلّ مجمّع.
  • SMART_NOTES_NAME: معرّف الملاحظة الذكية المحدّد في سجلّ اجتماع
  • ACCESS_TOKEN: الرمز المميز للوصول الذي يمنح إذن الوصول إلى واجهة برمجة التطبيقات.

عرض جميع الملاحظات الذكية

لعرض تفاصيل عن جميع ملفات الملاحظات الذكية في سجلّ اجتماع، استخدِم طريقة list في مورد smartNotes. اضبط مَعلمة المسار parent باستخدام التنسيق conferenceRecords/{conferenceRecord}.

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

cURL

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

غيِّر القيم في السلسلة على الشكل التالي:

  • PARENT_NAME: رقم تعريف مكالمة الفيديو المحدّد في سجلّ مكالمة فيديو
  • ACCESS_TOKEN: الرمز المميز للوصول الذي يمنح إذن الوصول إلى واجهة برمجة التطبيقات.

تخصيص تقسيم الصفحات

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

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

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