במדריך הזה מוסבר איך מקבלים פרטים על הארטיפקטים השונים של הפגישה שנוצרו על ידי שיחת ועידה באמצעות Google Meet REST API.
ארטיפקט הוא קובץ או נתונים שנוצרו על ידי Google Meet בתגובה לשיחת ועידה. ההגדרה הזו כוללת סרטונים ופריטים אחרים, כמו תמלילים.
כדי ליצור פריטי מידע מהפגישה, המשתתפים צריכים ליצור אותם ב-Meet לפני שהפגישה מסתיימת. התמלילים פועלים בנפרד מההקלטות, ולא צריך להקליט את הפגישה כדי ליצור תמליל. מידע נוסף זמין במאמרים איך מקליטים פגישות וידאו ואיך משתמשים בתמלילים ב-Google Meet.
אם אתם הבעלים של המרחב או משתתפים בו, אתם יכולים להתקשר אל get()
וlist()
בשיטות recordings
, transcripts
וtranscripts.entries
כדי לאחזר פריטי מידע.
אימות והרשאה באמצעות פרטי כניסה של משתמשים מאפשרים לאפליקציות של Google 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
מכיל את הסטטוס של סשן ההקלטה. כך תוכלו לבדוק אם ההקלטה התחילה, אם ההקלטה הסתיימה אבל קובץ ההקלטה לא מוכן, או אם קובץ ההקלטה נוצר ומוכן להורדה.
איך מקבלים פרטים על הקלטה
כדי לקבל פרטים על הקלטה ספציפית, משתמשים ב-method 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 REST API לא יהיו זהות לתמליל שמופיע בקובץ התמליל ב-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
מחליפים את ערך ההורה בשם של רשומת הוועידה ובשם התמליל.
התאמה אישית של מספור הדפים
מעבירים את הפרמטרים הבאים של השאילתה כדי להתאים אישית את המספור של ההקלטות, התמלילים והערכים בתמלילים:
pageSize
: מספר הפריטים המקסימלי שיוחזר. יכול להיות שהשירות יחזיר פחות מהערך הזה. אם לא מציינים, מוחזרים לכל היותר 10 פריטים. הערך המקסימלי הוא 100. ערכים שגדולים מ-100 משתנים אוטומטית ל-100.
pageToken
: טוקן דף שהתקבל מקריאה קודמת של רשימה. צריך לספק את האסימון הזה כדי לאחזר את הדף הבא.
נושאים קשורים
- איך מקליטים פגישות וידאו
- תמלול ב-Google Meet
- איך שומרים את הנתונים של Google Meet ב-Vault
- התאמה אישית של תכונות Meet כאדמינים