במדריך הזה נסביר איך לקבל פרטים על הפריטים השונים שנוצרו בפגישה באמצעות Google Meet API ל-REST.
אובייקט הוא קובץ או נתונים שנוצרו על ידי 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
מחליפים את שם התמליל בשם של מזהה התמליל הספציפי ברשומת פגישה.
הצגת רשימה של כל התמלילים
כדי לקבל רשימה של פרטים על כל התמלילים ברשומת פגישה, משתמשים ב-method list()
במשאב transcripts
עם פרמטר הנתיב parent
. פורמט:
conferenceRecords/{conferenceRecord}
.
השיטה מחזירה רשימה של תמלילי כנסים, שממוינים לפי startTime
בסדר עולה, כמכונה של משאב transcripts
. במאמר התאמה אישית של חלוקת הדפים מוסבר איך לשנות את גודל הדף.
בדוגמת הקוד הבאה מוסבר איך להציג את כל התמלילים בפרוטוקול של פגישה:
Java
Node.js
Python
מחליפים את ערך ההורה בשם של רשומת הכינוס.
רשומות של תמלילים
בקטעים הבאים מוסבר איך לקבל את הדיבור של כל משתתף כרשומה בתמליל במהלך פגישה עם תמליל של שיחת ועידה.
הרשומה של התמליל מכילה תמליל של הקול של המשתתף, עד 10,000 מילים לכל היותר. הטקסט המדובר languageCode
(לדוגמה, en-US
) נכלל גם כתחביר IETF BCP 47.
כל רשומה של תמליל מקושרת לשם participant
בפגישה. במאמר איך מקבלים פרטים על משתתף מוסבר איך מאחזרים את פרטי המשתתפים.
נתוני הרשומות של התמלילים זמינים למשך 30 יום לאחר סיום הכנס.
שימו לב: יכול להיות שהרשומות של התמליל שיוחזרו על ידי ה-API ל-REST של Meet לא יהיו זהות לתמליל שנמצא בקובץ התמליל ב-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 כאדמינים