เอกสารนี้อธิบายวิธีดูรายละเอียดเกี่ยวกับอาร์ติแฟกต์การประชุมต่างๆ ที่สร้างขึ้นจากการประชุมโดยใช้ 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 หากไม่ทราบชื่อการบันทึก
คุณสามารถแสดงชื่อการบันทึกทั้งหมดได้โดยใช้วิธีlist
เมธอดจะแสดงผลอินสแตนซ์ของทรัพยากร recordings
ตัวอย่างโค้ดต่อไปนี้แสดงวิธีดึงข้อมูลการบันทึกที่เฉพาะเจาะจง
Java
Node.js
Python
แทนที่ชื่อการบันทึกด้วยชื่อของรหัสการบันทึกที่เฉพาะเจาะจงใน บันทึกการประชุม
แสดงรายการการบันทึกทั้งหมด
หากต้องการแสดงรายละเอียดเกี่ยวกับการบันทึกทั้งหมดในบันทึกการประชุม ให้ใช้เมธอด
list
ในแหล่งข้อมูล
recordings
ที่มีพารามิเตอร์เส้นทาง parent รูปแบบคือ
conferenceRecords/{conferenceRecord}
เมธอดจะแสดงผลรายการการบันทึกการประชุมที่จัดเรียงตาม startTime ใน
ลำดับจากน้อยไปมากเป็นอินสแตนซ์ของทรัพยากร recordings หากต้องการปรับขนาดหน้าเว็บ ให้ดูปรับแต่งการแบ่งหน้า
ตัวอย่างโค้ดต่อไปนี้แสดงวิธีแสดงรายการการบันทึกทั้งหมดในการบันทึกการประชุม
Java
Node.js
Python
แทนที่ค่าขององค์ประกอบหลักด้วยชื่อของระเบียนการประชุม
ข้อความถอดเสียง
ส่วนต่อไปนี้จะอธิบายรายละเอียดวิธีดูข้อมูลเกี่ยวกับ ข้อความถอดเสียงการประชุมในบันทึกการประชุม
Meet จะมีสิทธิ์เข้าถึงรหัสข้อความถอดเสียงเมื่อระบบสร้างข้อมูลข้อความถอดเสียงแล้ว ผู้ใช้อาจลบไฟล์ข้อความถอดเสียงออกจากไดรฟ์ แต่ระบบจะยังแสดงชื่อที่ไม่ซ้ำกันใน Meet
แหล่งข้อมูล
transcripts
มีทั้งออบเจ็กต์
DocsDestination
และออบเจ็กต์
State
ออบเจ็กต์ DocsDestination จะเก็บตำแหน่งการส่งออกในไดรฟ์
ซึ่งเป็นที่บันทึกไฟล์ข้อความถอดเสียงของ Google เอกสาร หากต้องการดึงข้อมูลเนื้อหาหรือ
เรียกดูข้อความถอดเสียงในเบราว์เซอร์ ให้ใช้ค่าฟิลด์
exportUri
ของออบเจ็กต์ หากคุ้นเคยกับ Google เอกสาร 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 แสดงผลอาจไม่ตรงกับข้อความถอดเสียงที่พบในไฟล์ข้อความถอดเสียงของเอกสาร ปัญหานี้ เกิดขึ้นเมื่อมีการแก้ไขไฟล์ข้อความถอดเสียงหลังจากสร้างแล้ว
ดูรายละเอียดเกี่ยวกับรายการในบันทึก
หากต้องการดูรายละเอียดเกี่ยวกับรายการถอดเสียงที่เฉพาะเจาะจง ให้ใช้วิธี
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 จะมีสิทธิ์เข้าถึงรหัสโน้ตอัจฉริยะเมื่อระบบสร้างข้อมูลโน้ตอัจฉริยะแล้ว ผู้ใช้อาจลบไฟล์โน้ตอัจฉริยะออกจากไดรฟ์ แต่ระบบจะยังแสดงชื่อที่ไม่ซ้ำกันใน Meet
แหล่งข้อมูล smartNotes
มีออบเจ็กต์ State
ออบเจ็กต์นี้มีสถานะของเซสชันโน้ตอัจฉริยะ ซึ่งจะช่วยให้คุณค้นหาได้ว่าเซสชันโน้ตอัจฉริยะเริ่มแล้วหรือยัง เซสชันโน้ตอัจฉริยะสิ้นสุดแล้วแต่ไฟล์โน้ตอัจฉริยะยังไม่พร้อม หรือระบบสร้างไฟล์โน้ตอัจฉริยะและพร้อมให้ดาวน์โหลดแล้ว
นอกจากนี้ แหล่งข้อมูล smartNotes ยังมีออบเจ็กต์
DocsDestination
ประเภทด้วย ออบเจ็กต์นี้มีตำแหน่งการส่งออกในไดรฟ์ที่ระบบบันทึกไฟล์โน้ตอัจฉริยะของ Google เอกสาร หากต้องการดึงข้อมูลเนื้อหาหรือเรียกดู
โน้ตอัจฉริยะในเบราว์เซอร์ ให้ใช้ค่าฟิลด์
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: โทเค็นหน้าเว็บที่ได้รับจากการเรียกใช้ list ก่อนหน้า ระบุโทเค็นนี้ เพื่อดึงข้อมูลหน้าถัดไป