این راهنما توضیح میدهد که چگونه با استفاده از API REST گوگل میت، جزئیات مربوط به مصنوعات مختلف جلسه تولید شده توسط یک کنفرانس را دریافت کنید.
مصنوعات، فایل یا دادههایی هستند که توسط گوگل میت در پاسخ به یک کنفرانس تولید میشوند. این شامل ویدیوها و سایر مصنوعات، مانند رونوشتها، میشود.
برای تولید مصنوعات، شرکتکنندگان باید قبل از پایان کنفرانس، آنها را در Meet تولید کنند. رونوشتها مستقل از ضبطها عمل میکنند و برای تولید رونوشت لازم نیست جلسه را ضبط کنید. برای اطلاعات بیشتر، به ضبط جلسه ویدیویی و استفاده از رونوشتها با Google Meet مراجعه کنید.
اگر شما صاحب یا شرکتکنندهی فضای جلسه هستید، میتوانید متدهای get() و list() را در منابع recordings ، transcripts و transcripts.entries برای بازیابی مصنوعات فراخوانی کنید.
احراز هویت و مجوزدهی با استفاده از اعتبارنامههای کاربر به برنامههای Google Meet اجازه میدهد تا به دادههای کاربر دسترسی پیدا کرده و عملیات را از طرف کاربر احراز هویتشده انجام دهند. احراز هویت با واگذاری اختیارات در سطح دامنه به شما امکان میدهد تا حساب سرویس یک برنامه را برای دسترسی به دادههای کاربران خود بدون نیاز به رضایت هر کاربر، مجاز کنید.
حفظ مصنوعات
پس از پایان کنفرانس، Meet ضبطها و رونوشتها را در Google Drive سازماندهنده جلسه ذخیره میکند. بهطور پیشفرض، مصنوعات Meet طبق قوانین Drive حفظ میشوند.
ورودیهای رونوشت ارائه شده توسط Meet REST API، 30 روز پس از پایان کنفرانس حذف میشوند.
همچنین میتوانید با استفاده از قوانین نگهداری مختص Meet در Google Vault، نگهداری مصنوعات Meet را بهطور جداگانه مدیریت کنید. برای اطلاعات بیشتر، به بخش «نگهداری دادههای Google Meet با Vault» مراجعه کنید.
ضبطها
بخشهای زیر جزئیات نحوه دریافت اطلاعات مربوط به ضبطها در یک رکورد کنفرانس را شرح میدهند.
میت پس از ایجاد فایل ضبط، به شناسه ضبط دسترسی دارد. این امکان وجود دارد که کاربر فایل ضبط را از گوگل درایو حذف کند، اما نام منحصر به فرد همچنان در میت بازگردانده میشود.
منبع recordings شامل اشیاء DriveDestination و State است.
شیء DriveDestination محل خروجی گرفتن در Drive را نگه میدارد، جایی که ضبط به عنوان یک فایل MP4 ذخیره میشود. برای دانلود ضبط یا پخش آن در مرورگر، از مقدار فیلد exportUri شیء استفاده کنید. اگر با API گوگل درایو آشنا هستید، مقدار فیلد file با id در منبع files مطابقت دارد. برای اطلاعات بیشتر، به دانلود و خروجی گرفتن فایلها مراجعه کنید.
شیء State وضعیت جلسه ضبط را نگه میدارد. این به شما امکان میدهد تا بررسی کنید که آیا ضبط شروع شده است، آیا ضبط پایان یافته است اما فایل ضبط آماده نیست، یا اینکه فایل ضبط ایجاد شده و آماده دانلود است.
دریافت جزئیات مربوط به یک ضبط
برای دریافت جزئیات مربوط به یک رکورد خاص، از متد get() روی منبع recordings به همراه پارامتر name path استفاده کنید. اگر نام رکورد را نمیدانید، میتوانید با استفاده از متد list() تمام نامهای رکوردها را لیست کنید .
این متد نمونهای از یک منبع recordings را برمیگرداند.
نمونه کد زیر نحوه بازیابی یک ضبط خاص را نشان میدهد:
جاوا
نود جی اس
پایتون
نام ضبط را با نام شناسه ضبط خاص در یک رکورد کنفرانس جایگزین کنید.
فهرست کردن تمام ضبطها
برای فهرست کردن جزئیات مربوط به تمام ضبطها در یک رکورد کنفرانس، از متد list() روی منبع recordings به همراه پارامتر مسیر parent استفاده کنید. فرمت: conferenceRecords/{conferenceRecord} .
این متد لیستی از ضبطهای کنفرانس را که بر اساس startTime و به صورت صعودی مرتب شدهاند، به عنوان نمونهای از یک منبع recordings برمیگرداند. برای تنظیم اندازه صفحه، به سفارشیسازی صفحهبندی مراجعه کنید.
نمونه کد زیر نحوه فهرست کردن تمام ضبطها در یک رکورد کنفرانس را نشان میدهد:
جاوا
نود جی اس
پایتون
مقدار والد را با نام رکورد کنفرانس جایگزین کنید.
رونوشتها
بخشهای بعدی نحوه دریافت اطلاعات مربوط به رونوشتهای کنفرانس در یک پرونده کنفرانس را شرح میدهند.
Meet پس از تولید دادههای رونوشت، به شناسه رونوشت دسترسی دارد. این امکان وجود دارد که کاربر فایل رونوشت را از Drive حذف کند، اما نام منحصر به فرد همچنان در Meet بازگردانده میشود.
منبع transcripts شامل اشیاء DocsDestination و State است.
شیء DocsDestination محل خروجی گرفتن در درایو را که فایل رونوشت Google Docs در آن ذخیره شده است، نگه میدارد. برای دریافت محتوا یا مرور رونوشت در مرورگر، از مقدار فیلد exportUri شیء استفاده کنید. اگر با API Google Docs آشنا هستید، مقدار فیلد document با documentId در منبع documents مطابقت دارد.
شیء State وضعیت جلسه رونوشت را نگه میدارد. این به شما امکان میدهد تا بررسی کنید که آیا جلسه رونوشت آغاز شده است، آیا جلسه رونوشت پایان یافته است اما فایل رونوشت آماده نیست، یا اینکه آیا فایل رونوشت ایجاد شده و آماده دانلود است.
جزئیات مربوط به رونوشت را دریافت کنید
برای دریافت جزئیات مربوط به یک رونوشت خاص، از متد get() روی منبع transcripts به همراه پارامتر name path استفاده کنید. اگر نام رونوشت را نمیدانید، میتوانید تمام نامهای رونوشت را با استفاده از متد list() فهرست کنید.
این متد نمونهای از منبع transcripts را برمیگرداند.
نمونه کد زیر نحوه بازیابی یک رونوشت خاص را نشان میدهد:
جاوا
نود جی اس
پایتون
نام رونوشت را با نام شناسه رونوشت خاص در یک رکورد کنفرانس جایگزین کنید.
تمام رونوشتها را فهرست کنید
برای فهرست کردن جزئیات مربوط به تمام رونوشتها در یک رکورد کنفرانس، از متد list() روی منبع transcripts به همراه پارامتر مسیر parent استفاده کنید. فرمت: conferenceRecords/{conferenceRecord} .
این متد لیستی از رونوشتهای کنفرانس را که بر اساس startTime و به صورت صعودی مرتب شدهاند، به عنوان نمونهای از یک منبع transcripts برمیگرداند. برای تنظیم اندازه صفحه، به سفارشیسازی صفحهبندی مراجعه کنید.
نمونه کد زیر نحوه فهرست کردن تمام رونوشتها در یک رکورد کنفرانس را نشان میدهد:
جاوا
نود جی اس
پایتون
مقدار والد را با نام رکورد کنفرانس جایگزین کنید.
نوشتههای رونوشت
بخشهای بعدی نحوهی دریافت متن سخنرانی هر شرکتکننده را به عنوان ورودی در طول جلسهی متننویسی کنفرانس شرح میدهند.
ورودی رونوشت شامل متن آوانویسی شده صدای شرکتکننده، تا حداکثر ۱۰۰۰۰ کلمه است. متن گفتاری languageCode (برای مثال، en-US ) نیز به عنوان سینتکس IETF BCP 47 گنجانده شده است.
هر ورودی رونوشت به نام یک participant در کنفرانس مرتبط است. برای بازیابی جزئیات شرکتکننده، به «دریافت جزئیات درباره یک شرکتکننده» مراجعه کنید.
اطلاعات مربوط به ورود متن به مدت 30 روز پس از پایان کنفرانس در دسترس است.
توجه داشته باشید که ورودیهای رونوشت برگردانده شده توسط Meet REST API ممکن است با رونوشت موجود در فایل رونوشت Docs مطابقت نداشته باشند. این اتفاق زمانی رخ میدهد که فایل رونوشت پس از تولید تغییر یابد.
جزئیات مربوط به ورودی رونوشت را دریافت کنید
برای دریافت جزئیات مربوط به یک ورودی رونوشت خاص، از متد get() در منبع transcripts.entries به همراه پارامتر name path استفاده کنید. اگر نام ورودی رونوشت را نمیدانید، میتوانید تمام نامهای رونوشت را با استفاده از متد list() فهرست کنید.
این متد نمونهای از منبع transcripts.entries را برمیگرداند.
نمونه کد زیر نحوه بازیابی یک ورودی رونوشت خاص را نشان میدهد:
جاوا
نود جی اس
پایتون
نام ورودی رونوشت را با نام شناسه ورودی رونوشت خاص در یک رونوشت جایگزین کنید.
تمام ورودیهای رونوشت را فهرست کنید
برای فهرست کردن جزئیات مربوط به تمام ورودیهای رونوشت در یک رونوشت، از متد list() در منبع transcripts.entries به همراه پارامتر مسیر parent استفاده کنید. فرمت: conferenceRecords/{conferenceRecord}/transcripts/{transcript} .
این متد فهرستی از ورودیهای رونوشت ساختاریافته را به ازای هر رونوشت کنفرانس، که بر اساس startTime و به صورت صعودی مرتب شدهاند، به عنوان نمونهای از منبع transcripts.entries برمیگرداند. برای تنظیم اندازه صفحه، به سفارشیسازی صفحهبندی مراجعه کنید.
نمونه کد زیر نحوه فهرست کردن تمام ورودیهای رونوشت در یک رونوشت را نشان میدهد:
جاوا
نود جی اس
پایتون
مقدار والد را با نام رکورد کنفرانس و نام رونوشت جایگزین کنید.
سفارشیسازی صفحهبندی
پارامترهای کوئری زیر را برای سفارشیسازی صفحهبندی ضبطها، رونوشتها و ورودیهای رونوشت ارسال کنید:
pageSize: حداکثر تعداد آیتمهایی که باید برگردانده شوند. سرویس ممکن است کمتر از این مقدار را برگرداند. اگر مشخص نشود، حداکثر ۱۰ آیتم برگردانده میشود. حداکثر مقدار ۱۰۰ است؛ مقادیر بیش از ۱۰۰ به طور خودکار به ۱۰۰ تغییر میکنند.pageToken: یک توکن صفحه که از فراخوانی لیست قبلی دریافت شده است. این توکن را برای بازیابی صفحه بعدی ارائه دهید.
مباحث مرتبط
- ضبط جلسه ویدیویی
- استفاده از رونوشتها با Google Meet
- دادههای Google Meet را با Vault حفظ کنید
- سفارشیسازی ویژگیهای Meet به عنوان مدیر