يوضّح هذا المستند كيفية الحصول على تفاصيل حول عناصر اجتماع مختلفة تم إنشاؤها من خلال مؤتمر باستخدام 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.
يوضّح نموذج الرمز البرمجي التالي كيفية استرداد تسجيل معيّن:
جافا
Node.js
Python
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. لضبط حجم الصفحة، يُرجى الاطّلاع على تخصيص تقسيم المحتوى إلى صفحات .
يوضّح نموذج الرمز البرمجي التالي كيفية إدراج جميع التسجيلات في سجلّ مؤتمر:
جافا
Node.js
Python
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.
يوضّح نموذج الرمز البرمجي التالي كيفية استرداد نص معيّن:
جافا
Node.js
Python
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. لضبط حجم الصفحة، يُرجى الاطّلاع على تخصيص تقسيم المحتوى إلى صفحات .
يوضّح نموذج الرمز البرمجي التالي كيفية إدراج جميع النصوص في سجلّ اجتماع:
جافا
Node.js
Python
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.
يوضّح نموذج الرمز البرمجي التالي كيفية استرداد إدخال نصي معيّن:
جافا
Node.js
Python
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. لتعديل حجم الصفحة، يُرجى الاطّلاع على تخصيص تقسيم المحتوى إلى صفحات .
يوضّح نموذج الرمز البرمجي التالي كيفية إدراج جميع إدخالات نص الفيديو في نص الفيديو:
جافا
Node.js
Python
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 حيث يتم حفظ ملف الملاحظات الذكية في "مستندات Google". لاسترداد المحتوى أو تصفّح الملاحظات الذكية في متصفّح، استخدِم قيمة الحقل 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: رمز مميز للصفحة تم تلقّيه من طلب قائمة سابق. قدِّم هذا الرمز المميز لاسترداد الصفحة التالية.