يوضّح هذا الدليل كيفية الحصول على تفاصيل عن عناصر الاجتماع المختلفة التي أنشأتها مكالمة فيديو باستخدام Google Meet REST API.
العنصر هو ملف أو بيانات أنشأها Google Meet استجابةً ل مكالمة فيديو. ويشمل ذلك الفيديوهات وغيرها من العناصر، مثل النصوص.
لإنشاء العناصر، على المشاركين إنشاؤها في Meet قبل انتهاء المؤتمر. تعمل النصوص بشكل مستقل عن التسجيلات، ولا تحتاج إلى تسجيل الاجتماع لإنشاء نص. لمزيد من المعلومات، يُرجى الاطّلاع على مقالتَي تسجيل اجتماع فيديو واستخدام النصوص المكتوبة مع Google Meet.
إذا كنت مالكًا لمساحة اجتماع أو مشاركًا فيها، يمكنك استدعاء الطريقتَين get()
و
list()
في recordings
وtranscripts
و
transcripts.entries
لاسترداد العناصر.
تسمح عملية المصادقة والتفويض باستخدام بيانات اعتماد المستخدِم لتطبيقات Google 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
. إذا كنت لا تعرف اسم التسجيل،
يمكنك إدراج جميع أسماء التسجيلات باستخدام طريقة list()
.
تُرجع الطريقة مثيلًا لمورد recordings
.
يوضّح نموذج الرمز البرمجي التالي كيفية استرداد تسجيل معيّن:
Java
Node.js
Python
استبدِل اسم التسجيل باسم رقم تعريف التسجيل المحدّد في سجلّ المؤتمر.
عرض قائمة بجميع التسجيلات
لعرض تفاصيل عن جميع التسجيلات في سجلّ مؤتمر، استخدِم الأسلوب
list()
على المورد recordings
مع مَعلمة المسار parent
. التنسيق:
conferenceRecords/{conferenceRecord}
تُرجع الطريقة قائمة بتسجيلات المؤتمرات، مرتبة حسب startTime
بترتيب
تصاعدي، كنسخة من مورد recordings
. لضبط حجم
الصفحة، اطّلِع على تخصيص تقسيم الصفحات .
يوضّح نموذج الرمز البرمجي التالي كيفية إدراج جميع التسجيلات في تسجيل مكالمة جماعية:
Java
Node.js
Python
استبدِل قيمة العنصر الرئيسي باسم سجلّ المؤتمر.
الصوت المحوَّل إلى نص
توضّح الأقسام التالية بالتفصيل كيفية الحصول على معلومات عن ملفّات مناقشات مكالمات الفيديو في سجلّ مكالمة فيديو.
يمكن لمنصة Meet الوصول إلى رقم تعريف النص بعد إنشاء بيانات النص. من الممكن أن يحذف المستخدم ملف النص من Drive، ولكن يظل الاسم الفريد معروضًا في Meet.
يتضمّن المورد transcripts
كلاً من العنصرين
DocsDestination
و
State
.
يحتوي العنصر DocsDestination
على مكان التصدير في Drive
حيث يتم حفظ ملف نص المكالمة في "مستندات Google". لجلب المحتوى أو
تصفّح النص في متصفّح، استخدِم قيمة حقل exportUri
للعنصر. إذا
كنت على دراية بخدمة Google Docs API، تتوافق قيمة الحقل document
مع
documentId
في مورد documents
.
يحتوي عنصر State
على حالة جلسة النص. يتيح لك ذلك معرفة ما إذا كانت جلسة إنشاء النص قد بدأت، أو ما إذا كانت قد انتهت ولكنه لم يتم إنشاء ملف النص، أو ما إذا تم إنشاء ملف النص وأصبح جاهزًا للتنزيل.
الحصول على تفاصيل حول نص
للحصول على تفاصيل عن نصّ معيّن، استخدِم الأسلوب
get()
على العنصر
transcripts
مع مَعلمة المسار name
. إذا كنت لا تعرف اسم النص،
يمكنك إدراج جميع أسماء النصوص باستخدام list()
الطريقة.
تُرجع الطريقة مثيلًا لمورد transcripts
.
يوضّح نموذج الرمز البرمجي التالي كيفية استرداد نصّ محدّد:
Java
Node.js
Python
استبدِل اسم نص المحادثة باسم رقم تعريف نص المحادثة المحدّد في سجلّ المؤتمر.
عرض قائمة بجميع النصوص
لعرض تفاصيل عن جميع النصوص في سجلّ مؤتمر، استخدِم الأسلوب
list()
في مورد
transcripts
مع مَعلمة المسار parent
. التنسيق:
conferenceRecords/{conferenceRecord}
تُرجع الطريقة قائمة بنصوص المؤتمرات، مرتبة حسب startTime
بترتيب صعودي، كنسخة من مورد transcripts
. لضبط حجم
الصفحة، اطّلِع على تخصيص تقسيم الصفحات .
يوضّح نموذج الرمز البرمجي التالي كيفية إدراج جميع النصوص في تسجيل مكالمة جماعية:
Java
Node.js
Python
استبدِل قيمة العنصر الرئيسي باسم سجلّ المؤتمر.
إدخالات النص
توضّح الأقسام التالية بالتفصيل كيفية الحصول على كلمات كل مشارك في شكل إدخالات في نص المكالمة أثناء جلسة نص مكالمة مؤتمر.
يحتوي إدخال النص على نص مكتوب لصوت المشارك، بما يصل إلى
10,000 كلمة كحد أقصى. يتم أيضًا تضمين النص المنطوق languageCode
(مثل en-US
)
باستخدام بنية IETF BCP 47.
يرتبط كل إدخال في النص بأحد أسماء participant
في المؤتمر. ل retrieving participant details، اطّلِع على الحصول على تفاصيل عن أحد المشاركين.
تتوفّر بيانات إدخال النص لمدة 30 يومًا بعد انتهاء المؤتمر.
يُرجى العِلم أنّ إدخالات النص التي تعرضها Meet REST API قد لا تتطابق مع النص الوارد في ملف النص في "مستندات Google". ويحدث ذلك عند تعديل ملف النص بعد إنشائه.
الحصول على تفاصيل حول إدخال نص
للحصول على تفاصيل عن إدخال نص معيّن، استخدِم الأسلوب
get()
في المورد
transcripts.entries
مع مَعلمة المسار name
. إذا كنت لا تعرف اسم إدخال ملف الترجمة والشرح، يمكنك إدراج جميع أسماء ملفات الترجمة والشرح باستخدام الطريقة
list()
.
تُرجع الطريقة مثيلًا لمورد transcripts.entries
.
يوضّح نموذج الرمز البرمجي التالي كيفية استرداد إدخال نصي محدّد:
Java
Node.js
Python
استبدِل اسم إدخال النص بقيمة ملف تعريف العميل الخاصة بإدخال النص في ملف تعريف العميل.
إدراج جميع إدخالات النص
لعرض تفاصيل عن جميع إدخالات النص في نص، استخدِم الأسلوب
list()
في مورد
transcripts.entries
مع مَعلمة المسار parent
. التنسيق:
conferenceRecords/{conferenceRecord}/transcripts/{transcript}
تُرجع الطريقة قائمة بإدخالات نصّ المنسَّق لكل ملف اتّصال
نصّ، مرتبة حسب startTime
تصاعديًا، كمثيل لمورد
transcripts.entries
. لضبط حجم الصفحة، اطّلِع على تخصيص
التقسيم إلى صفحات .
يوضِّح نموذج الرمز البرمجي التالي كيفية إدراج جميع إدخالات نص المحادثة في نص المحادثة:
Java
Node.js
Python
استبدِل قيمة العنصر الرئيسي باسم سجلّ المؤتمر واسم نص المحادثة.
تخصيص تقسيم الصفحات
نقْل مَعلمات طلبات البحث التالية لتخصيص تقسيم الصفحات للتسجيلات والنصوص وسجلّات النصوص:
pageSize
: الحد الأقصى لعدد السلع التي يمكن إرجاعها قد تعرِض الخدمة عددًا أقل من هذه القيمة. إذا لم يتم تحديد عدد، يتم عرض 10 عناصر كحدّ أقصى. تبلغ القيمة القصوى 100، ويتم تلقائيًا تغيير القيم التي تزيد عن 100 إلى 100.pageToken
: رمز مميّز للصفحة، تم تلقّيه من طلب قائمة سابق قدِّم هذا الرمز المميّز لاسترداد الصفحة اللاحقة.
مواضيع ذات صلة
- تسجيل اجتماع فيديو
- استخدام ميزة "النصوص" في Google Meet
- الاحتفاظ ببيانات Google Meet باستخدام أداة Vault
- تخصيص ميزات Meet بصفتك مشرفًا