يوضّح هذا الدليل كيفية الحصول على تفاصيل حول عناصر اجتماع مختلفة تم إنشاؤها من خلال اجتماع باستخدام واجهة برمجة تطبيقات Google Meet REST.
العنصر هو ملف أو بيانات ينشئها Google Meet استجابةً لاجتماع. ويشمل ذلك الفيديوهات وغيرها من العناصر، مثل النصوص.
لإنشاء عناصر، على المشاركين إنشاؤها في Meet قبل انتهاء المؤتمر. تعمل النصوص بشكل مستقل عن التسجيلات، ولا تحتاج إلى تسجيل الاجتماع لإنشاء نص. لمزيد من المعلومات، يُرجى الاطّلاع على تسجيل اجتماع فيديو واستخدام النصوص مع Google Meet.
إذا كنت مالكًا لمساحة اجتماع أو مشاركًا فيها، يمكنك استدعاء الطريقتَين get()
وlist()
في المراجع recordings
وtranscripts
وtranscripts.entries
لاسترداد العناصر.
تتيح المصادقة والتفويض باستخدام بيانات اعتماد المستخدم لتطبيقات Google Meet الوصول إلى بيانات المستخدم وتنفيذ عمليات نيابةً عن المستخدم الذي تمت المصادقة عليه. يتيح لك المصادقة باستخدام التفويض على مستوى النطاق تفويض حساب خدمة أحد التطبيقات للوصول إلى بيانات المستخدمين بدون طلب موافقة كل مستخدم.
الاحتفاظ بالبيانات
بعد انتهاء مؤتمر، يحفظ Meet التسجيلات والنصوص في Google Drive الخاص بمنظِّم الاجتماع. يتم تلقائيًا الاحتفاظ ببيانات Meet وفقًا لقواعد Drive.
تتم إزالة إدخالات النصوص التي يوفّرها واجهة برمجة تطبيقات REST في Meet بعد 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 Docs. لاسترداد المحتوى أو تصفّح نص الفيديو في متصفّح، استخدِم قيمة الحقل 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
في الاجتماع. لاسترداد تفاصيل المشاركين، راجِع الحصول على تفاصيل حول أحد المشاركين.
تتوفّر بيانات إدخال نص الاجتماع لمدة 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 بصفتك مشرفًا