במאמר הזה מוסבר איך מקבלים פרטים על פריטי המידע השונים שנוצרו מפגישה ב-Meet שנוצרו על ידי ועידה באמצעות Google Meet API בארכיטקטורת REST.
פריט מידע שנוצר מפגישה הוא קובץ או נתונים שנוצרו על ידי Google Meet בתגובה לפגישה. הנתונים האלה כוללים הקלטות של סרטונים ופריטי מידע אחרים, כמו תמלילים וסיכומים חכמים.
כדי ליצור פריטים שנוצרו מפגישה, המשתתפים צריכים להגדיר אותם ב-Meet לפני שהפגישה מסתיימת. מידע נוסף מופיע במאמר בנושא ניהול ארטיפקטים אוטומטיים.
התמלילים פועלים באופן עצמאי מההקלטות, ולא צריך להקליט את הפגישה כדי ליצור תמליל. כשכל המשתתפים עוזבים את הפגישה, התמלול נפסק אוטומטית. מידע נוסף זמין במאמרים איך מקליטים פגישות וידאו ואיך משתמשים בתמלילים ב-Google Meet.
אחזור פריטים שנוצרו מפגישות
אם אתם הבעלים של מרחב לפגישות או משתתפים בו, אתם יכולים להתקשר לשיטות get ו-list במשאבים recordings, transcripts, transcripts.entries ו-smartNotes כדי לאחזר ארטיפקטים. מידע נוסף זמין בסעיפים הבאים.
אימות ומתן הרשאה באמצעות פרטי כניסה של משתמשים מאפשרים לאפליקציות של Meet לגשת לנתוני משתמשים ולבצע פעולות בשם המשתמש המאומת. אימות באמצעות הענקת הרשאות גישה ברמת הדומיין מאפשר לתת הרשאה לחשבון השירות של אפליקציה לגשת לנתונים של המשתמשים בלי שכל משתמש יצטרך לתת את ההסכמה שלו.
שמירת ארטיפקטים
אחרי ששיחת הוועידה מסתיימת, ההקלטות, התמלילים והסיכומים החכמים נשמרים ב-Google Drive של מארגן הפגישה. כברירת מחדל, פריטים שנוצרו ב-Meet נשמרים בהתאם לכללים של Drive.
תמלילים שנוצרו באמצעות Meet API בארכיטקטורת REST נמחקים 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 באמצעות הפורמט conferenceRecords/{conferenceRecord}/recordings/{recordingName}.
אם אתם לא יודעים את שם ההקלטה, אתם יכולים לרשום את כל שמות ההקלטות באמצעות השיטה list.
השיטה מחזירה מופע של משאב recordings.
בדוגמת הקוד הבאה אפשר לראות איך מאחזרים הקלטה ספציפית:
Java
Node.js
Python
cURL
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. כדי לשנות את גודל הדף, אפשר לעיין במאמר בנושא התאמה אישית של מעברי עמוד.
בדוגמת הקוד הבאה אפשר לראות איך מציגים רשימה של כל ההקלטות ברשומה של שיחת ועידה:
Java
Node.js
Python
cURL
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 מכיל את מיקום הייצוא ב-Drive שבו נשמר קובץ התמליל של Google Docs. כדי לאחזר את התוכן או לעיין בתמליל בדפדפן, משתמשים בערך השדה exportUri של האובייקט. אם אתם מכירים את Google Docs API, הערך של השדה document תואם לערך של documentId במשאב documents.
האובייקט State מכיל את הסטטוס של סשן התמלול. האפשרות הזו מאפשרת לכם לבדוק אם סשן התמליל התחיל, אם סשן התמליל הסתיים אבל קובץ התמליל לא מוכן, או אם קובץ התמליל נוצר ומוכן להורדה.
איך רואים פרטים על תמליל
כדי לקבל פרטים על תמליל ספציפי, משתמשים בשיטה get במשאב transcripts. מגדירים את פרמטר הנתיב name באמצעות הפורמט conferenceRecords/{conferenceRecord}/transcripts/{transcriptName}.
אם אתם לא יודעים את שם התמליל, אתם יכולים לרשום את כל שמות התמלילים באמצעות השיטה list.
השיטה מחזירה מופע של משאב transcripts.
בדוגמת הקוד הבאה אפשר לראות איך מאחזרים תמליל ספציפי:
Java
Node.js
Python
cURL
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. כדי לשנות את גודל הדף, אפשר לעיין במאמר בנושא התאמה אישית של מעברי עמוד.
בדוגמת הקוד הבאה אפשר לראות איך מציגים רשימה של כל התמלילים בהקלטה של שיחת ועידה:
Java
Node.js
Python
cURL
curl -X GET \
"https://meet.googleapis.com/v2/conferenceRecords/PARENT_NAME/transcripts" \
-H "Authorization: Bearer ACCESS_TOKEN"
מחליפים את ACCESS_TOKEN באסימון הגישה שמעניק גישה ל-API.
מחליפים את שם ההורה בשם של מזהה הוועידה הספציפי ברשומה של הוועידה.
רשומות בתמליל
בקטעים הבאים מוסבר איך לקבל את הדיבור של כל משתתף כרשומות בתמליל במהלך הפגישה.
רשומה בתמליל מכילה תמליל של קול המשתתף, עד למקסימום של 10,000 מילים. הטקסט המדובר languageCode (לדוגמה, en-US)
נכלל גם כתחביר IETF BCP 47.
כל רשומה בתמליל מקושרת לparticipantשם של משתתף בוועידה. כדי לאחזר את פרטי המשתתפים, אפשר לעיין במאמר בנושא קבלת פרטים על משתתף.
נתוני הכניסה לתמליל זמינים למשך 30 יום אחרי סיום הוועידה.
שימו לב: יכול להיות שהרשומות בתמליל שמוחזרות על ידי API בארכיטקטורת REST של Meet לא יהיו זהות לתמליל שנמצא בקובץ התמליל ב-Docs. המצב הזה קורה כשקובץ התמליל משתנה אחרי שהוא נוצר.
איך רואים פרטים על רשומה בתמליל
כדי לקבל פרטים על רשומה ספציפית בתמליל, משתמשים בשיטה get במשאב transcripts.entries. מגדירים את פרמטר הנתיב name באמצעות הפורמט conferenceRecords/{conferenceRecord}/transcripts/{transcriptName}/entries/{transcriptEntryName}.
אם אתם לא יודעים את שם רשומת התמלול, אתם יכולים לרשום את כל שמות רשומות התמלול באמצעות השיטה list.
השיטה מחזירה מופע של משאב transcripts.entries.
בדוגמת הקוד הבאה אפשר לראות איך מאחזרים רשומה ספציפית בתמליל:
Java
Node.js
Python
cURL
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. כדי לשנות את גודל הדף, אפשר לעיין במאמר בנושא התאמה אישית של מספור הדפים.
בדוגמת הקוד הבאה אפשר לראות איך מציגים רשימה של כל הרשומות בתמליל:
Java
Node.js
Python
cURL
curl -X GET \
"https://meet.googleapis.com/v2/conferenceRecords/CONFERENCE_RECORD_NAME/transcripts/TRANSCRIPT_NAME/entries" \
-H "Authorization: Bearer ACCESS_TOKEN"
מחליפים את ACCESS_TOKEN באסימון הגישה שמעניק גישה ל-API.
מחליפים את מה שכתוב בשדות הבאים:
- שם מאזן השיחות עם השם של מזהה שיחה ספציפי במאזן השיחות.
- שם התמליל עם השם של מזהה התמליל הספציפי ברשומה של שיחת ועידה.
סיכום חכם
בקטעים הבאים מוסבר איך לקבל מידע על סיכום חכם של שיחות ועידה בהקלטה של שיחת ועידה.
ל-Meet יש גישה למזהה של הסיכום החכם אחרי שהנתונים של הסיכום החכם נוצרים. יכול להיות שמשתמש ימחק את קובץ הסיכום החכם מ-Drive, אבל השם הייחודי עדיין יופיע ב-Meet.
המשאב
smartNotes
כולל את האובייקט
State. האובייקט הזה מכיל את הסטטוס של סשן הסיכום החכם. כך תוכלו לבדוק אם סשן הסיכום החכם התחיל, אם סשן הסיכום החכם הסתיים אבל קובץ הסיכום החכם לא מוכן, או אם קובץ הסיכום החכם נוצר ומוכן להורדה.
המשאב smartNotes כולל גם את סוג האובייקט DocsDestination. האובייקט הזה מכיל את מיקום הייצוא ב-Drive שבו נשמר קובץ הסיכום החכם של Google Docs. כדי לאחזר את התוכן או לעיין בסיכום החכם בדפדפן, משתמשים בערך השדה exportUri של האובייקט. אם אתם מכירים את Google Docs API, הערך של השדה document תואם לערך של documentId במשאב documents.
אפשר לנהל את הסיכומים החכמים באמצעות ה-methods get ו-list.
איך מקבלים פרטים על סיכום חכם
כדי לקבל פרטים על קובץ מסוים של סיכומים חכמים, משתמשים בשיטה get במשאב smartNotes. מגדירים את פרמטר הנתיב name באמצעות הפורמט conferenceRecords/{conferenceRecord}/smartNotes/{smartNote}.
אם אתם לא יודעים את השם של הסיכום החכם, אתם יכולים לרשום את כל הקבצים של הסיכומים החכמים באמצעות השיטה list.
השיטה מחזירה מופע של משאב smartNotes.
בדוגמת הקוד הבאה אפשר לראות איך מאחזרים קובץ ספציפי של סיכום חכם:
Java
import com.google.apps.meet.v2.ConferenceRecordsServiceClient;
import com.google.apps.meet.v2.SmartNote;
public class GetSmartNote {
public static void main(String[] args) throws Exception {
try (ConferenceRecordsServiceClient client =
ConferenceRecordsServiceClient.create()) {
SmartNote response = client.getSmartNote(
"conferenceRecords/CONFERENCE_RECORD_NAME/smartNotes/SMART_NOTES_NAME");
System.out.println("Smart note name: " + response.getName());
}
}
}
Node.js
const {ConferenceRecordsServiceClient} = require('@google-apps/meet').v2;
async function getSmartNote(smartNoteName) {
const client = new ConferenceRecordsServiceClient();
const [response] = await client.getSmartNote({name: smartNoteName});
console.log(`Smart note name: ${response.name}`);
return response;
}
Python
from google.apps import meet_v2
def get_smart_note(smart_note_name):
client = meet_v2.ConferenceRecordsServiceClient()
response = client.get_smart_note(name=smart_note_name)
print(f"Smart note name: {response.name}")
return response
cURL
curl -X GET \
"https://meet.googleapis.com/v2/conferenceRecords/CONFERENCE_RECORD_NAME/smartNotes/SMART_NOTES_NAME" \
-H "Authorization: Bearer ACCESS_TOKEN"
מחליפים את ACCESS_TOKEN באסימון הגישה שמעניק גישה ל-API.
מחליפים את מה שכתוב בשדות הבאים:
- שם מאזן השיחות עם השם של מזהה שיחה ספציפי במאזן השיחות.
- שם ההערה החכמה עם השם של מזהה ההערה החכמה הספציפי ברשומה של שיחה.
הצגת רשימה של כל הסיכומים החכמים
כדי לראות רשימה של פרטים על כל קובצי הסיכום החכם ברשומה של שיחה, משתמשים בשיטה list במשאב smartNotes. מגדירים את פרמטר הנתיב parent באמצעות הפורמט conferenceRecords/{conferenceRecord}.
השיטה מחזירה רשימה של קבצים של סיכומי פגישות חכמים, שממוינים לפי startTime בסדר עולה, כמופע של משאב smartNotes. כדי לשנות את גודל הדף, אפשר לקרוא את המאמר בנושא התאמה אישית של חלוקה לעמודים.
בדוגמת הקוד הבאה אפשר לראות איך מציגים רשימה של כל קובצי הסיכום החכם של פגישה:
Java
import com.google.apps.meet.v2.ConferenceRecordsServiceClient;
import com.google.apps.meet.v2.SmartNote;
public class ListSmartNotes {
public static void main(String[] args) throws Exception {
try (ConferenceRecordsServiceClient client =
ConferenceRecordsServiceClient.create()) {
for (SmartNote smartNote : client
.listSmartNotes("conferenceRecords/CONFERENCE_RECORD_NAME")
.iterateAll()) {
System.out.println("Smart note name: " + smartNote.getName());
}
}
}
}
Node.js
const {ConferenceRecordsServiceClient} = require('@google-apps/meet').v2;
async function listSmartNotes(conferenceRecordName) {
const client = new ConferenceRecordsServiceClient();
const [smartNotes] =
await client.listSmartNotes({parent: conferenceRecordName});
smartNotes.forEach((smartNote) => {
console.log(`Smart note name: ${smartNote.name}`);
});
return smartNotes;
}
Python
from google.apps import meet_v2
def list_smart_notes(conference_record_name):
client = meet_v2.ConferenceRecordsServiceClient()
response = client.list_smart_notes(parent=conference_record_name)
for smart_note in response:
print(f"Smart note name: {smart_note.name}")
cURL
curl -X GET \
"https://meet.googleapis.com/v2/conferenceRecords/PARENT_NAME/smartNotes" \
-H "Authorization: Bearer ACCESS_TOKEN"
מחליפים את ACCESS_TOKEN באסימון הגישה שמעניק גישה ל-API.
מחליפים את שם ההורה בשם של מזהה הוועידה הספציפי ברשומה של הוועידה.
התאמה אישית של חלוקה לעמודים
כדי להתאים אישית את המספור של ההקלטות, התמלילים, רשומות התמליל והסיכומים החכמים, מעבירים את פרמטרי השאילתה הבאים:
pageSize: המספר המקסימלי של הפריטים שיוחזרו. יכול להיות שהשירות יחזיר פחות מהערך הזה. אם לא מציינים ערך, המערכת תחזיר עד 10 פריטים. הערך המקסימלי הוא 100. ערכים שגדולים מ-100 משתנים אוטומטית ל-100.
pageToken: טוקן של דף שהתקבל מקריאה קודמת של list. צריך להזין את הטוקן הזה כדי לאחזר את הדף הבא.