במסמך הזה מוסבר איך מקבלים פרטים על הארטיפקטים השונים של הפגישה שנוצרו על ידי ועידה באמצעות Google Meet API בארכיטקטורת REST.
ארטיפקט הוא קובץ או נתונים שנוצרו על ידי Google Meet בתגובה לפגישה. הנתונים האלה כוללים הקלטות של סרטונים ופריטי מידע אחרים, כמו תמלילים.
כדי ליצור פריטים שנוצרו מפגישה, המשתתפים צריכים להגדיר אותם ב-Meet לפני שהפגישה מסתיימת. מידע נוסף זמין במאמר בנושא ניהול ארטיפקטים אוטומטיים.
התמלילים פועלים בנפרד מההקלטות, ולא צריך להקליט את הפגישה כדי ליצור תמליל. כשכל המשתתפים עוזבים את הפגישה, התמלול נפסק אוטומטית. מידע נוסף זמין במאמרים איך מקליטים פגישות וידאו ואיך משתמשים בתמלילים ב-Google Meet.
אחזור פריטים שנוצרו מפגישות
אם אתם הבעלים של מרחב לפגישות או משתתפים בו, אתם יכולים להתקשר לשיטות get ו-list במשאבים recordings, transcripts, transcripts.entries ו-smart notes כדי לאחזר ארטיפקטים. מידע נוסף זמין בסעיפים הבאים.
אימות ומתן הרשאה באמצעות פרטי כניסה של משתמשים מאפשרים לאפליקציות של Meet לגשת לנתוני משתמשים ולבצע פעולות בשם המשתמש המאומת. אימות באמצעות הענקת הרשאות גישה ברמת הדומיין מאפשר לתת הרשאה לחשבון השירות של האפליקציה לגשת לנתוני המשתמשים בלי שכל משתמש יצטרך לתת את הסכמתו.
שמירת תוצרי הפגישה
אחרי שהשיחה מסתיימת, ההקלטות והתמלילים נשמרים ב-Google Drive בחשבון של מארגן/ת הפגישה. כברירת מחדל, פריטי מידע מ-Meet נשמרים בהתאם לכללים של Drive.
רשומות בתמליל שסופקו על ידי API בארכיטקטורת REST של Meet נמחקות 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 API בארכיטקטורת REST לא יהיה זהה לתמליל שמופיע בקובץ התמליל ב-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 Docs. כדי לאחזר את התוכן או לעיין בסיכום החכם בדפדפן, משתמשים בערך השדה 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: טוקן של דף שהתקבל מקריאה קודמת של רשימה. צריך להזין את הטוקן הזה כדי לאחזר את הדף הבא.