يوضّح هذا المستند كيفية الحصول على تفاصيل حول عناصر اجتماع مختلفة تم إنشاؤها بواسطة مؤتمر باستخدام 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. إذا كنت لا تعرف اسم التسجيل، يمكنك إدراج جميع أسماء التسجيلات باستخدام طريقة 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 قد لا تتطابق مع النص الذي تم العثور عليه في ملف نص اجتماع Docs. يحدث ذلك عند تعديل ملف نص الفيديو بعد إنشائه.
الحصول على تفاصيل حول إدخال في نص
للحصول على تفاصيل حول إدخال معيّن في نص الفيديو، استخدِم طريقة
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
استبدِل قيمة العنصر الأصل باسم سجلّ المؤتمر واسم نص الاجتماع.
الملاحظات الذكية
توضّح الأقسام التالية بالتفصيل كيفية الحصول على معلومات حول الملاحظات الذكية في مكالمة فيديو ضمن سجلّ مكالمة فيديو.
يتمكّن Meet من الوصول إلى معرّف الملاحظة الذكية بعد إنشاء بيانات الملاحظة الذكية. من المحتمل أن يحذف المستخدم ملف الملاحظات الذكية من Drive، ولكن سيظل الاسم الفريد يظهر في Meet.
يتضمّن المرجع smartNotes الكائن State.
يحتوي هذا العنصر على حالة جلسة الملاحظات الذكية. يتيح لك ذلك الاستعلام عمّا إذا كانت جلسة "الملاحظات الذكية" قد بدأت، أو إذا كانت قد انتهت ولكن ملف "الملاحظات الذكية" غير جاهز، أو إذا تم إنشاء ملف "الملاحظات الذكية" وأصبح جاهزًا للتنزيل.
يتضمّن المرجع smartNotes أيضًا نوع العنصر DocsDestination. يحتوي هذا العنصر على موقع التصدير في Drive حيث يتم حفظ ملف الملاحظات الذكية في "مستندات Google". لاسترداد المحتوى أو تصفّح الملاحظات الذكية في متصفّح، استخدِم قيمة الحقل exportUri الخاص بالكائن. إذا كنت على دراية بواجهة Google Docs API، يتوافق
قيمة الحقل document
مع
documentId
في المرجع documents.
يمكنك إدارة الملاحظات الذكية باستخدام الطريقتَين get وlist.
الحصول على تفاصيل حول "الملخّصات الذكية"
للحصول على تفاصيل حول ملف "الملاحظات الذكية" معيّن، استخدِم طريقة
get في مورد
smartNotes مع
مَعلمة المسار name. إذا كنت لا تعرف اسم الملاحظات الذكية، يمكنك إدراج جميع ملفات الملاحظات الذكية باستخدام الطريقة list.
تعرض الطريقة مثيلاً لمورد smartNotes.
عرض جميع الملاحظات الذكية
لعرض تفاصيل حول جميع ملفات الملاحظات الذكية في سجلّ اجتماع، استخدِم طريقة
list في مورد
smartNotes مع
مَعلمة المسار parent. التنسيق هو
conferenceRecords/{conferenceRecord}.
تعرض الطريقة قائمة بملفات "الملاحظات الذكية في الاجتماعات"، ويتم ترتيبها حسب startTime بترتيب تصاعدي، وذلك كمثيل لمورد smartNotes. لتعديل حجم الصفحة، اطّلِع على تخصيص تقسيم المحتوى إلى صفحات .
تخصيص تقسيم الصفحات
مرِّر مَعلمات طلب البحث التالية لتخصيص تقسيم التسجيلات والنصوص والفيديوهات إلى صفحات:
pageSize: الحد الأقصى لعدد السلع التي يمكن إرجاعها قد تعرض الخدمة عددًا أقل من هذه القيمة. إذا لم يتم تحديد عدد، سيتم عرض 10 عناصر كحدّ أقصى. القيمة القصوى هي 100، ويتم تلقائيًا تغيير القيم الأكبر من 100 إلى 100.pageToken: رمز مميز للصفحة تم تلقّيه من طلب قائمة سابق. قدِّم هذا الرمز المميز لاسترداد الصفحة التالية.