เอกสารนี้อธิบายวิธีดูรายละเอียดเกี่ยวกับอาร์ติแฟกต์การประชุมต่างๆ ที่สร้างขึ้นจากการประชุมโดยใช้ Google Meet REST API
อาร์ติแฟกต์คือไฟล์หรือข้อมูลที่ Google Meet สร้างขึ้นเพื่อตอบสนองต่อการประชุม ซึ่งรวมถึง วิดีโอที่บันทึกไว้และอาร์ติแฟกต์อื่นๆ เช่น ข้อความถอดเสียง
หากต้องการสร้างอาร์ติแฟกต์ ผู้เข้าร่วมต้องกำหนดค่าใน Meet ก่อนที่การประชุมจะสิ้นสุด ดูข้อมูลเพิ่มเติมได้ที่จัดการอาร์ติแฟกต์อัตโนมัติ
ข้อความถอดเสียงจะทำงานแยกจากการบันทึก และคุณไม่จำเป็นต้องบันทึกการประชุมเพื่อสร้างข้อความถอดเสียง ข้อความถอดเสียงจะหยุดโดยอัตโนมัติเมื่อผู้เข้าร่วมทุกคนออกจากการประชุม โปรดดูข้อมูลเพิ่มเติมที่หัวข้อบันทึกการประชุมทางวิดีโอและใช้ข้อความถอดเสียง กับ Google Meet
ดึงข้อมูลอาร์ติแฟกต์
หากคุณเป็นเจ้าของหรือผู้เข้าร่วมพื้นที่การประชุม คุณสามารถเรียกใช้เมธอด get และ
list ในทรัพยากร recordings, transcripts, transcripts.entries และ
smart notes เพื่อดึงข้อมูลอาร์ติแฟกต์ ดูข้อมูลเพิ่มเติมได้ที่
ส่วนต่อไปนี้
การตรวจสอบสิทธิ์และการให้สิทธิ์ด้วยข้อมูลเข้าสู่ระบบ ของผู้ใช้ช่วยให้ แอป Meet เข้าถึงข้อมูลผู้ใช้และดำเนินการในนามของ ผู้ใช้ที่ผ่านการตรวจสอบสิทธิ์ได้ การตรวจสอบสิทธิ์ด้วยการมอบสิทธิ์ทั่วทั้งโดเมน ช่วยให้คุณให้สิทธิ์บัญชีบริการของแอปพลิเคชันในการเข้าถึงข้อมูลของผู้ใช้ โดยไม่ต้องขอความยินยอมจากผู้ใช้แต่ละราย
การเก็บรักษาอาร์ติแฟกต์
หลังจากที่การประชุมสิ้นสุดลง Meet จะบันทึกวิดีโอและข้อความถอดเสียงไว้ใน Google ไดรฟ์ของผู้จัดการประชุม โดยค่าเริ่มต้น ระบบจะเก็บรักษาอาร์ติแฟกต์ของ Meet ตามกฎของไดรฟ์
ระบบจะลบรายการถอดเสียงที่ REST API ของ Meet แสดงหลังจากที่การประชุมสิ้นสุดลง 30 วัน
นอกจากนี้ คุณยังจัดการการเก็บรักษาอาร์ติแฟกต์ของ Meet แยกกันได้ โดยใช้กฎการเก็บรักษาเฉพาะของ Meet ใน Google ห้องนิรภัย โปรดดูข้อมูลเพิ่มเติมที่หัวข้อเก็บข้อมูล Google Meet ด้วยห้องนิรภัย
การบันทึก
ส่วนต่อไปนี้จะอธิบายรายละเอียดวิธีรับข้อมูลเกี่ยวกับการบันทึกใน บันทึกการประชุม
Meet จะมีสิทธิ์เข้าถึงรหัสการบันทึกหลังจากสร้างไฟล์บันทึกแล้ว ผู้ใช้อาจลบไฟล์บันทึกออกจาก Google ไดรฟ์ แต่ระบบจะยังแสดงชื่อที่ไม่ซ้ำกันใน Meet
แหล่งข้อมูล
recordings
มีทั้งออบเจ็กต์
DriveDestination
และออบเจ็กต์
State
DriveDestination object จะเก็บตำแหน่งการส่งออกในไดรฟ์
ซึ่งระบบจะบันทึกไฟล์บันทึกเป็นไฟล์ 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 จะมีสิทธิ์เข้าถึงรหัสข้อความถอดเสียงเมื่อระบบสร้างข้อมูลข้อความถอดเสียงแล้ว ผู้ใช้อาจลบไฟล์ข้อความถอดเสียงออกจากไดรฟ์ แต่ระบบจะยังแสดงชื่อที่ไม่ซ้ำกันใน Meet
แหล่งข้อมูล
transcripts
มีทั้งออบเจ็กต์
DocsDestination
และออบเจ็กต์
State
ออบเจ็กต์ DocsDestination จะเก็บตำแหน่งการส่งออกในไดรฟ์
ซึ่งเป็นที่บันทึกไฟล์ข้อความถอดเสียงของ Google เอกสาร หากต้องการดึงข้อมูลเนื้อหาหรือ
เรียกดูข้อความถอดเสียงในเบราว์เซอร์ ให้ใช้ค่าฟิลด์
exportUri
ของออบเจ็กต์ หากคุ้นเคยกับ Google เอกสาร 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 วันหลังจากที่การประชุมสิ้นสุดลง
โปรดทราบว่ารายการข้อความถอดเสียงที่ Meet REST API แสดงผลอาจไม่ตรงกับข้อความถอดเสียงที่พบในไฟล์ข้อความถอดเสียงของเอกสาร ปัญหานี้ เกิดขึ้นเมื่อมีการแก้ไขไฟล์ข้อความถอดเสียงหลังจากสร้างแล้ว
ดูรายละเอียดเกี่ยวกับรายการในข้อความถอดเสียง
หากต้องการดูรายละเอียดเกี่ยวกับรายการถอดเสียงที่เฉพาะเจาะจง ให้ใช้เมธอด
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/PARENT_NAME/transcripts/TRANSCRIPT_NAME/entries" \
-H "Authorization: Bearer ACCESS_TOKEN"
แทนที่ ACCESS_TOKEN ด้วยโทเค็นเพื่อการเข้าถึงที่ให้สิทธิ์เข้าถึง API
แทนที่ค่าต่อไปนี้
- ชื่อผู้ปกครองที่มีชื่อรหัสการประชุมที่เฉพาะเจาะจงในบันทึกการประชุม
- ชื่อข้อความถอดเสียงพร้อมชื่อของรหัสข้อความถอดเสียงที่เฉพาะเจาะจงใน บันทึกการประชุม
โน้ตอัจฉริยะ
ส่วนต่อไปนี้จะอธิบายรายละเอียดวิธีดูข้อมูลเกี่ยวกับสมาร์ทโน้ตของการประชุมในบันทึกการประชุม
Meet จะมีสิทธิ์เข้าถึงรหัสโน้ตอัจฉริยะเมื่อระบบสร้างข้อมูลโน้ตอัจฉริยะแล้ว ผู้ใช้อาจลบไฟล์โน้ตอัจฉริยะออกจากไดรฟ์ แต่ระบบจะยังแสดงชื่อที่ไม่ซ้ำกันใน Meet
แหล่งข้อมูล smartNotes
มีออบเจ็กต์ State
ออบเจ็กต์นี้มีสถานะของเซสชันโน้ตอัจฉริยะ ซึ่งจะช่วยให้คุณค้นหาได้ว่าเซสชันโน้ตอัจฉริยะเริ่มแล้วหรือยัง เซสชันโน้ตอัจฉริยะสิ้นสุดแล้วแต่ไฟล์โน้ตอัจฉริยะยังไม่พร้อม หรือระบบสร้างไฟล์โน้ตอัจฉริยะและพร้อมให้ดาวน์โหลดแล้ว
นอกจากนี้ ทรัพยากร smartNotes ยังมีออบเจ็กต์
DocsDestination
ประเภทด้วย ออบเจ็กต์นี้มีตำแหน่งการส่งออกในไดรฟ์ที่ระบบบันทึกไฟล์โน้ตอัจฉริยะของ Google เอกสาร หากต้องการดึงข้อมูลเนื้อหาหรือเรียกดู
โน้ตอัจฉริยะในเบราว์เซอร์ ให้ใช้ค่าฟิลด์
exportUri
ของออบเจ็กต์ หากคุณคุ้นเคยกับ Google Docs API ค่าฟิลด์ document
จะสอดคล้องกับ
documentId
ในทรัพยากร documents
คุณจัดการโน้ตอัจฉริยะได้โดยใช้เมธอด get และ
list
ดูรายละเอียดเกี่ยวกับโน้ตอัจฉริยะ
หากต้องการดูรายละเอียดเกี่ยวกับไฟล์โน้ตอัจฉริยะที่เฉพาะเจาะจง ให้ใช้เมธอด
get
ใน
smartNotes
ตั้งค่าพารามิเตอร์เส้นทาง name โดยใช้รูปแบบ
conferenceRecords/{conferenceRecord}/smartNotes/{smartNote}
หากไม่ทราบชื่อโน้ตอัจฉริยะ คุณสามารถแสดงรายการไฟล์
โน้ตอัจฉริยะทั้งหมดได้โดยใช้วิธีlist
เมธอดจะแสดงผลอินสแตนซ์ของทรัพยากร smartNotes
cURL
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
curl -X GET "https://meet.googleapis.com/v2beta/conferenceRecords/PARENT_NAME/smartNotes" \
-H "Authorization: Bearer ACCESS_TOKEN"
แทนที่ค่าต่อไปนี้
- PARENT_NAME: รหัสการประชุมที่เฉพาะเจาะจงในบันทึกการประชุม
- ACCESS_TOKEN: โทเค็นการเข้าถึงที่ให้สิทธิ์เข้าถึง API
ปรับแต่งการแบ่งหน้า
ส่งพารามิเตอร์การค้นหาต่อไปนี้เพื่อปรับแต่งการแบ่งหน้าของไฟล์บันทึก ข้อความถอดเสียง และรายการข้อความถอดเสียง
pageSize: จำนวนสินค้าสูงสุดที่คืนได้ บริการอาจแสดงผลน้อยกว่าค่านี้ หากไม่ระบุ ระบบจะแสดงผลรายการอย่างน้อย 10 รายการ ค่าสูงสุดคือ 100 และระบบจะเปลี่ยนค่าที่มากกว่า 100 เป็น 100 โดยอัตโนมัติpageToken: โทเค็นหน้าเว็บที่ได้รับจากการเรียกใช้ list ก่อนหน้า ระบุโทเค็นนี้ เพื่อดึงข้อมูลหน้าถัดไป