این سند توضیح میدهد که چگونه میتوان با استفاده از API REST گوگل میت، جزئیات مربوط به مصنوعات مختلف جلسه تولید شده توسط یک کنفرانس را دریافت کرد.
مصنوعات، فایل یا دادههایی هستند که توسط گوگل میت در پاسخ به یک کنفرانس تولید میشوند. این شامل ضبط ویدیو و سایر مصنوعات، مانند رونوشتها، میشود.
برای تولید مصنوعات، شرکتکنندگان باید قبل از پایان کنفرانس، آنها را در Meet پیکربندی کنند. برای اطلاعات بیشتر، به مدیریت مصنوعات خودکار مراجعه کنید.
رونوشتها مستقل از ضبطها عمل میکنند و برای تولید رونوشت لازم نیست جلسه را ضبط کنید. وقتی همه شرکتکنندگان جلسه را ترک میکنند، رونوشت به طور خودکار متوقف میشود. برای اطلاعات بیشتر، به ضبط جلسه ویدیویی و استفاده از رونوشتها با Google Meet مراجعه کنید.
بازیابی آثار باستانی
اگر شما صاحب یا شرکتکنندهی فضای جلسه هستید، میتوانید متدهای get و list را در منابع recordings ، transcripts ، transcripts.entries و smart notes برای بازیابی مصنوعات فراخوانی کنید. برای اطلاعات بیشتر، به بخشهای بعدی مراجعه کنید.
احراز هویت و مجوزدهی با استفاده از اعتبارنامههای کاربر به برنامههای 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 مطابقت دارد. برای اطلاعات بیشتر، به Download and export files مراجعه کنید.
شیء State وضعیت جلسه ضبط را نگه میدارد. این به شما امکان میدهد تا بررسی کنید که آیا ضبط شروع شده است، آیا ضبط پایان یافته است اما فایل ضبط آماده نیست، یا اینکه فایل ضبط ایجاد شده و آماده دانلود است.
دریافت جزئیات مربوط به یک ضبط
برای دریافت جزئیات مربوط به یک ضبط خاص، از متد get در منبع recordings استفاده کنید. پارامتر مسیر name را با استفاده از فرمت conferenceRecords/{conferenceRecord}/recordings/{recordingName} تنظیم کنید.
اگر نام ضبط را نمیدانید، میتوانید با استفاده از روش list ، تمام نامهای ضبط را فهرست کنید .
این متد نمونهای از یک منبع recordings را برمیگرداند.
نمونه کد زیر نحوه بازیابی یک ضبط خاص را نشان میدهد:
جاوا
نود جی اس
پایتون
حلقه
curl -X GET "https://meet.googleapis.com/v2/conferenceRecords/CONFERENCE_RECORD_NAME/recordings/RECORDING_NAME" \
-H "Authorization: Bearer ACCESS_TOKEN"
ACCESS_TOKEN با توکن دسترسی که دسترسی به API را اعطا میکند، جایگزین کنید.
موارد زیر را جایگزین کنید:
- نام رکورد کنفرانس به همراه نام شناسه کنفرانس خاص در یک رکورد کنفرانس.
- نام ضبط به همراه نام شناسه ضبط خاص در یک رکورد کنفرانس.
فهرست کردن تمام ضبطها
برای فهرست کردن جزئیات مربوط به تمام ضبطها در یک رکورد کنفرانس، از متد list در منبع recordings استفاده کنید. پارامتر مسیر parent را با استفاده از فرمت conferenceRecords/{conferenceRecord} تنظیم کنید.
این متد لیستی از ضبطهای کنفرانس را که بر اساس startTime و به صورت صعودی مرتب شدهاند، به عنوان نمونهای از یک منبع recordings برمیگرداند. برای تنظیم اندازه صفحه، به سفارشیسازی صفحهبندی مراجعه کنید.
نمونه کد زیر نحوه فهرست کردن تمام ضبطها در یک رکورد کنفرانس را نشان میدهد:
جاوا
نود جی اس
پایتون
حلقه
curl -X GET "https://meet.googleapis.com/v2/conferenceRecords/PARENT_NAME/recordings" \
-H "Authorization: Bearer ACCESS_TOKEN"
ACCESS_TOKEN با توکن دسترسی که دسترسی به API را اعطا میکند، جایگزین کنید.
نام والد را با نام شناسه کنفرانس خاص در یک رکورد کنفرانس جایگزین کنید.
رونوشتها
بخشهای بعدی نحوه دریافت اطلاعات مربوط به رونوشتهای کنفرانس در یک پرونده کنفرانس را شرح میدهند.
Meet پس از تولید دادههای رونوشت، به شناسه رونوشت دسترسی دارد. این امکان وجود دارد که کاربر فایل رونوشت را از Drive حذف کند، اما نام منحصر به فرد همچنان در Meet بازگردانده میشود.
منبع transcripts شامل اشیاء DocsDestination و State است.
شیء DocsDestination محل خروجی گرفتن در درایو را که فایل رونوشت Google Docs در آن ذخیره شده است، نگه میدارد. برای دریافت محتوا یا مرور رونوشت در مرورگر، از مقدار فیلد exportUri شیء استفاده کنید. اگر با API Google Docs آشنا هستید، مقدار فیلد document با documentId در منبع documents مطابقت دارد.
شیء State وضعیت جلسه رونوشت را نگه میدارد. این به شما امکان میدهد تا بررسی کنید که آیا جلسه رونوشت آغاز شده است، آیا جلسه رونوشت پایان یافته است اما فایل رونوشت آماده نیست، یا اینکه آیا فایل رونوشت ایجاد شده و آماده دانلود است.
جزئیات مربوط به رونوشت را دریافت کنید
برای دریافت جزئیات مربوط به یک رونوشت خاص، از متد get در منبع transcripts استفاده کنید. پارامتر مسیر name را با استفاده از فرمت conferenceRecords/{conferenceRecord}/transcripts/{transcriptName} تنظیم کنید.
اگر نام رونوشت را نمیدانید، میتوانید با استفاده از روش list ، تمام نامهای رونوشت را فهرست کنید .
این متد نمونهای از منبع transcripts را برمیگرداند.
نمونه کد زیر نحوه بازیابی یک رونوشت خاص را نشان میدهد:
جاوا
نود جی اس
پایتون
حلقه
curl -X GET "https://meet.googleapis.com/v2/conferenceRecords/CONFERENCE_RECORD_NAME/transcripts/TRANSCRIPT_NAME" \
-H "Authorization: Bearer ACCESS_TOKEN"
ACCESS_TOKEN با توکن دسترسی که دسترسی به API را اعطا میکند، جایگزین کنید.
موارد زیر را جایگزین کنید:
- نام رکورد کنفرانس به همراه نام شناسه کنفرانس خاص در یک رکورد کنفرانس.
- نام رونوشت به همراه نام شناسه رونوشت خاص در یک رکورد کنفرانس.
تمام رونوشتها را فهرست کنید
برای فهرست کردن جزئیات مربوط به تمام رونوشتها در یک رکورد کنفرانس، از متد list در منبع transcripts استفاده کنید. پارامتر مسیر parent را با استفاده از فرمت conferenceRecords/{conferenceRecord} تنظیم کنید.
این متد لیستی از رونوشتهای کنفرانس را که بر اساس startTime و به صورت صعودی مرتب شدهاند، به عنوان نمونهای از یک منبع transcripts برمیگرداند. برای تنظیم اندازه صفحه، به سفارشیسازی صفحهبندی مراجعه کنید.
نمونه کد زیر نحوه فهرست کردن تمام رونوشتها در یک رکورد کنفرانس را نشان میدهد:
جاوا
نود جی اس
پایتون
حلقه
curl -X GET "https://meet.googleapis.com/v2/conferenceRecords/PARENT_NAME/transcripts" \
-H "Authorization: Bearer ACCESS_TOKEN"
ACCESS_TOKEN با توکن دسترسی که دسترسی به API را اعطا میکند، جایگزین کنید.
نام والد را با نام شناسه کنفرانس خاص در یک رکورد کنفرانس جایگزین کنید.
نوشتههای رونوشت
بخشهای بعدی نحوهی دریافت متن سخنرانی هر شرکتکننده را به عنوان ورودی در طول جلسهی متننویسی کنفرانس شرح میدهند.
ورودی رونوشت شامل متن آوانویسی شده صدای شرکتکننده، تا حداکثر ۱۰۰۰۰ کلمه است. متن گفتاری languageCode (برای مثال، en-US ) نیز به عنوان سینتکس IETF BCP 47 گنجانده شده است.
هر ورودی رونوشت به نام یک participant در کنفرانس مرتبط است. برای بازیابی جزئیات شرکتکننده، به «دریافت جزئیات درباره یک شرکتکننده» مراجعه کنید.
اطلاعات مربوط به ورود متن به مدت 30 روز پس از پایان کنفرانس در دسترس است.
توجه داشته باشید که ورودیهای رونوشت برگردانده شده توسط Meet REST API ممکن است با رونوشت موجود در فایل رونوشت Docs مطابقت نداشته باشند. این اتفاق زمانی رخ میدهد که فایل رونوشت پس از تولید تغییر یابد.
جزئیات مربوط به ورودی رونوشت را دریافت کنید
برای دریافت جزئیات مربوط به یک ورودی خاص رونوشت، از متد get در منبع transcripts.entries استفاده کنید. پارامتر name path را با استفاده از فرمت conferenceRecords/{conferenceRecord}/transcripts/{transcriptName}/entries/{transcriptEntryName} تنظیم کنید.
اگر نام ورودی رونوشت را نمیدانید، میتوانید با استفاده از روش list ، تمام نامهای ورودی رونوشت را فهرست کنید .
این متد نمونهای از منبع transcripts.entries را برمیگرداند.
نمونه کد زیر نحوه بازیابی یک ورودی رونوشت خاص را نشان میدهد:
جاوا
نود جی اس
پایتون
حلقه
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 با توکن دسترسی که دسترسی به API را اعطا میکند، جایگزین کنید.
موارد زیر را جایگزین کنید:
- نام رکورد کنفرانس به همراه نام شناسه کنفرانس خاص در یک رکورد کنفرانس.
- نام رونوشت به همراه نام شناسه رونوشت خاص در یک رکورد کنفرانس.
- نام مدخل رونوشت به همراه نام شناسه مدخل رونوشت خاص در یک رونوشت.
تمام ورودیهای رونوشت را فهرست کنید
برای فهرست کردن جزئیات مربوط به تمام ورودیهای رونوشت در یک رونوشت، از متد list در منبع transcripts.entries استفاده کنید. پارامتر مسیر parent را با استفاده از فرمت conferenceRecords/{conferenceRecord}/transcripts/{transcript} تنظیم کنید.
این متد فهرستی از ورودیهای رونوشت ساختاریافته را به ازای هر رونوشت کنفرانس، که بر اساس startTime و به صورت صعودی مرتب شدهاند، به عنوان نمونهای از منبع transcripts.entries برمیگرداند. برای تنظیم اندازه صفحه، به سفارشیسازی صفحهبندی مراجعه کنید.
نمونه کد زیر نحوه فهرست کردن تمام ورودیهای رونوشت در یک رونوشت را نشان میدهد:
جاوا
نود جی اس
پایتون
حلقه
curl -X GET "https://meet.googleapis.com/v2/conferenceRecords/PARENT_NAME/transcripts/TRANSCRIPT_NAME/entries" \
-H "Authorization: Bearer ACCESS_TOKEN"
ACCESS_TOKEN با توکن دسترسی که دسترسی به API را اعطا میکند، جایگزین کنید.
موارد زیر را جایگزین کنید:
- نام والد به همراه نام شناسه کنفرانس خاص در یک رکورد کنفرانس.
- نام رونوشت به همراه نام شناسه رونوشت خاص در یک رکورد کنفرانس.
یادداشتهای هوشمند
بخشهای بعدی نحوه دریافت اطلاعات مربوط به یادداشتهای هوشمند کنفرانس در یک رکورد کنفرانس را شرح میدهند.
پس از تولید دادههای یادداشت هوشمند، Meet به شناسه یادداشت هوشمند دسترسی دارد. این امکان وجود دارد که کاربر فایل یادداشتهای هوشمند را از Drive حذف کند، اما نام منحصر به فرد همچنان در Meet بازگردانده میشود.
منبع smartNotes شامل شیء State است. این شیء وضعیت جلسه یادداشتهای هوشمند را در خود نگه میدارد. این به شما امکان میدهد تا بررسی کنید که آیا جلسه یادداشتهای هوشمند شروع شده است، آیا جلسه یادداشتهای هوشمند پایان یافته است اما فایل یادداشتهای هوشمند آماده نیست، یا اینکه فایل یادداشتهای هوشمند ایجاد شده و آماده دانلود است.
منبع smartNotes همچنین شامل نوع شیء DocsDestination است. این شیء محل خروجی گرفتن در Drive را که فایل یادداشتهای هوشمند Google Docs در آن ذخیره شده است، نگه میدارد. برای دریافت محتوا یا مرور یادداشتهای هوشمند در مرورگر، از مقدار فیلد exportUri شیء استفاده کنید. اگر با API Google Docs آشنا هستید، مقدار فیلد document با documentId در منبع documents مطابقت دارد.
شما میتوانید یادداشتهای هوشمند را با استفاده از متدهای get و list مدیریت کنید.
جزئیات مربوط به یادداشتهای هوشمند را دریافت کنید
برای دریافت جزئیات مربوط به یک فایل یادداشت هوشمند خاص، از متد get در smartNotes استفاده کنید. پارامتر مسیر name را با استفاده از فرمت conferenceRecords/{conferenceRecord}/smartNotes/{smartNote} تنظیم کنید.
اگر نام یادداشتهای هوشمند را نمیدانید، میتوانید با استفاده از روش list ، تمام فایلهای یادداشتهای هوشمند را فهرست کنید .
این متد یک نمونه از منبع smartNotes را برمیگرداند.
حلقه
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 : توکن دسترسی که دسترسی به API را اعطا میکند.
فهرست کردن تمام یادداشتهای هوشمند
برای فهرست کردن جزئیات مربوط به تمام فایلهای یادداشت هوشمند در یک رکورد کنفرانس، از متد list در منبع smartNotes استفاده کنید. پارامتر مسیر parent را با استفاده از فرمت conferenceRecords/{conferenceRecord} تنظیم کنید.
این متد لیستی از فایلهای یادداشتهای هوشمند کنفرانس را که بر اساس startTime و به صورت صعودی مرتب شدهاند، به عنوان نمونهای از یک منبع smartNotes برمیگرداند. برای تنظیم اندازه صفحه، به بخش «سفارشیسازی صفحهبندی» مراجعه کنید.
حلقه
curl -X GET "https://meet.googleapis.com/v2beta/conferenceRecords/PARENT_NAME/smartNotes" \
-H "Authorization: Bearer ACCESS_TOKEN"
موارد زیر را جایگزین کنید:
- PARENT_NAME : شناسه کنفرانس خاص در یک رکورد کنفرانس.
- ACCESS_TOKEN : توکن دسترسی که دسترسی به API را اعطا میکند.
سفارشیسازی صفحهبندی
پارامترهای کوئری زیر را برای سفارشیسازی صفحهبندی ضبطها، رونوشتها و ورودیهای رونوشت ارسال کنید:
pageSize: حداکثر تعداد آیتمهایی که باید برگردانده شوند. سرویس ممکن است کمتر از این مقدار را برگرداند. اگر مشخص نشود، حداکثر ۱۰ آیتم برگردانده میشود. حداکثر مقدار ۱۰۰ است؛ مقادیر بیش از ۱۰۰ به طور خودکار به ۱۰۰ تغییر میکنند.pageToken: یک توکن صفحه که از فراخوانی لیست قبلی دریافت شده است. این توکن را برای بازیابی صفحه بعدی ارائه دهید.