این راهنما نحوه دریافت جزئیات مربوط به مصنوعات مختلف جلسه را که توسط یک کنفرانس با استفاده از 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 در Google Vault، حفظ مصنوعات Meet را به طور جداگانه مدیریت کنید. برای اطلاعات بیشتر، به حفظ دادههای 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 را برمی گرداند.
نمونه کد زیر نحوه بازیابی یک ضبط خاص را نشان می دهد:
جاوا
Node.js
پایتون
نام ضبط را با نام شناسه ضبط خاص در یک رکورد کنفرانس جایگزین کنید.
لیست تمام موارد ضبط شده
برای فهرست کردن جزئیات مربوط به همه ضبطها در یک رکورد کنفرانس، از متد list() در منبع recordings با پارامتر مسیر parent استفاده کنید. فرمت: conferenceRecords/{conferenceRecord} .
این روش فهرستی از ضبطهای کنفرانس را که توسط startTime به ترتیب صعودی مرتب شدهاند، به عنوان نمونهای از منبع recordings برمیگرداند. برای تنظیم اندازه صفحه، به سفارشی کردن صفحه بندی مراجعه کنید.
نمونه کد زیر نحوه فهرست کردن تمام موارد ضبط شده در یک رکورد کنفرانس را نشان می دهد:
جاوا
Node.js
پایتون
مقدار والد را با نام رکورد کنفرانس جایگزین کنید.
رونوشت ها
بخشهای زیر نحوه دریافت اطلاعات در مورد رونوشتهای کنفرانس در رکورد کنفرانس را شرح میدهد.
هنگامی که دادههای رونوشت تولید شد، Meet به شناسه رونوشت دسترسی دارد. ممکن است کاربر فایل رونوشت را از Drive حذف کند، اما نام منحصر به فرد همچنان در Meet برگردانده میشود.
منبع transcripts هم شامل DocsDestination و هم اشیاء State است.
شی DocsDestination مکان صادرات را در Drive نگه می دارد که فایل رونوشت Google Docs در آن ذخیره می شود. برای واکشی محتوا یا مرور رونوشت در مرورگر، از مقدار فیلد exportUri شی استفاده کنید. اگر با Google Docs API آشنا هستید، مقدار فیلد document با documentId در منبع documents مطابقت دارد.
شی State وضعیت جلسه رونوشت را نگه می دارد. این به شما امکان میدهد که آیا جلسه رونوشت شروع شده است، آیا جلسه رونوشت به پایان رسیده است اما فایل رونوشت آماده نیست یا اینکه فایل رونوشت تولید شده و آماده دانلود است، سؤال کنید.
جزئیات مربوط به رونوشت را دریافت کنید
برای دریافت جزئیات در مورد یک رونوشت خاص، از متد get() در منبع transcripts با پارامتر مسیر name استفاده کنید. اگر نام رونوشت را نمیدانید، میتوانید همه نامهای رونوشت را با استفاده از متد list() فهرست کنید.
این روش نمونه ای از یک منبع transcripts را برمی گرداند.
نمونه کد زیر نحوه بازیابی یک رونوشت خاص را نشان می دهد:
جاوا
Node.js
پایتون
نام رونوشت را با نام شناسه رونوشت خاص در یک رکورد کنفرانس جایگزین کنید.
فهرست همه رونوشت ها
برای فهرست کردن جزئیات مربوط به تمام رونوشت ها در یک رکورد کنفرانس، از متد list() در منبع transcripts با پارامتر مسیر parent استفاده کنید. فرمت: conferenceRecords/{conferenceRecord} .
این روش فهرستی از رونوشت های کنفرانس را که توسط startTime به ترتیب صعودی مرتب شده اند، به عنوان نمونه ای از منبع transcripts برمی گرداند. برای تنظیم اندازه صفحه، به سفارشی کردن صفحه بندی مراجعه کنید.
نمونه کد زیر نحوه فهرست کردن همه رونوشت ها در یک رکورد کنفرانس را نشان می دهد:
جاوا
Node.js
پایتون
مقدار والد را با نام رکورد کنفرانس جایگزین کنید.
ورودی های رونوشت
بخشهای زیر نحوه دریافت سخنرانی هر یک از شرکتکنندگان را بهعنوان نوشتههای متن در طول جلسه متن کنفرانس توضیح میدهد.
ورودی متن شامل متن رونویسی شده از صدای شرکت کننده، حداکثر تا 10000 کلمه است. languageCode نوشتاری گفتاری (به عنوان مثال، en-US ) نیز به عنوان نحو IETF BCP 47 گنجانده شده است.
هر ورودی متن به نام participant در کنفرانس متصل می شود. برای بازیابی جزئیات شرکتکننده، به دریافت جزئیات درباره یک شرکتکننده مراجعه کنید.
اطلاعات ورودی رونوشت به مدت 30 روز پس از پایان کنفرانس در دسترس است.
توجه داشته باشید که ورودیهای رونوشت برگردانده شده توسط Meet REST API ممکن است با رونویسی موجود در فایل رونوشت Docs مطابقت نداشته باشد. این زمانی اتفاق می افتد که فایل رونوشت پس از تولید اصلاح شود.
جزئیات مربوط به ورودی رونوشت را دریافت کنید
برای دریافت جزئیات در مورد یک ورودی رونوشت خاص، از متد get() در منبع transcripts.entries با پارامتر مسیر name استفاده کنید. اگر نام ورودی رونوشت را نمیدانید، میتوانید همه نامهای رونوشت را با استفاده از متد list() فهرست کنید.
این روش نمونه ای از یک منبع transcripts.entries را برمی گرداند.
نمونه کد زیر نحوه بازیابی یک ورودی رونوشت خاص را نشان می دهد:
جاوا
Node.js
پایتون
نام ورودی رونوشت را با نام شناسه ورودی رونوشت خاص در رونوشت جایگزین کنید.
تمام ورودی های رونوشت را فهرست کنید
برای فهرست کردن جزئیات مربوط به تمام ورودیهای رونوشت در یک رونوشت، از متد list() در منبع transcripts.entries با پارامتر مسیر parent استفاده کنید. قالب: conferenceRecords/{conferenceRecord}/transcripts/{transcript} .
این روش فهرستی از ورودیهای رونوشت ساختیافته را در هر رونوشت کنفرانس، که توسط startTime به ترتیب صعودی مرتب شدهاند، به عنوان نمونهای از منبع transcripts.entries برمیگرداند. برای تنظیم اندازه صفحه، به سفارشی کردن صفحه بندی مراجعه کنید.
نمونه کد زیر نحوه فهرست کردن تمام ورودیهای رونوشت را در یک رونوشت نشان میدهد:
جاوا
Node.js
پایتون
مقدار والد را با نام رکورد کنفرانس و نام رونوشت جایگزین کنید.
صفحه بندی را سفارشی کنید
برای سفارشیسازی صفحهبندی ضبطها، رونوشتها و ورودیهای رونوشت، پارامترهای پرس و جوی زیر را ارسال کنید:
pageSize: حداکثر تعداد مواردی که باید برگردانده شوند. ممکن است این سرویس کمتر از این مقدار را برگرداند. اگر نامشخص باشد، حداکثر 10 مورد برگردانده می شود. حداکثر مقدار 100 است. مقادیر بیش از 100 به طور خودکار به 100 تغییر می کنند.pageToken: یک نشانه صفحه، دریافت شده از یک تماس فهرست قبلی. این نشانه را برای بازیابی صفحه بعدی ارائه دهید.
موضوعات مرتبط
- یک جلسه ویدیویی را ضبط کنید
- از رونوشتها با Google Meet استفاده کنید
- دادههای Google Meet را با Vault حفظ کنید
- ویژگیهای Meet را به عنوان سرپرست سفارشی کنید