เริ่มต้นใช้งาน Meet Media API

หากต้องการใช้ Google Meet Media API และขอบเขต OAuth 2.0 ที่เกี่ยวข้อง แอปของคุณต้องเป็นไปตามข้อกำหนดต่อไปนี้

ข้อกำหนดทางเทคนิค

ระบบจะบังคับใช้ข้อจำกัดต่อไปนี้เมื่อทำงานกับ Meet Media API

เพื่อให้ได้ผลลัพธ์และการสนับสนุนที่ดีที่สุด ให้ทำดังนี้

  • ไคลเอ็นต์ควร ใช้ไลบรารี libwebrtc และเวอร์ชัน ไม่ควร ล้าหลังการเผยแพร่ STABLE Chromium เวอร์ชันล่าสุดไม่เกิน 12 เดือน เบราว์เซอร์ Chromium ใช้ libwebrtc เพื่อติดตั้งใช้งาน WebRTC JavaScript API

  • ไคลเอ็นต์ควร รักษาแบนด์วิดท์ขั้นต่ำที่ 4 Mbps

เปิดใช้ Meet REST API

ก่อนที่จะใช้ Google APIs คุณต้องเปิดใช้ API เหล่านั้นในโปรเจ็กต์ที่อยู่ในระบบคลาวด์ของ Google คุณสามารถเปิดใช้ API อย่างน้อย 1 รายการในโปรเจ็กต์ Google Cloud เดียว

นโยบายการเลิกใช้งานตัวแปลงสัญญาณ

  • Google ขอสงวนสิทธิ์ในการหยุดใช้ตัวแปลงสัญญาณได้ทุกเมื่อ

  • เมื่อมีการเปิดตัวตัวแปลงสัญญาณใหม่ นักพัฒนาแอปจะได้รับการแจ้งล่วงหน้า 12 เดือน ก่อนที่ไคลเอ็นต์จะต้องรองรับตัวแปลงสัญญาณนี้

การตรวจสอบสิทธิ์และการให้สิทธิ์

ไคลเอ็นต์ Google Meet Media API จะเชื่อมต่อกับการประชุมในนามของผู้ใช้ที่เฉพาะเจาะจง โดยใช้ OAuth 2.0 ในการตรวจสอบสิทธิ์และ การให้สิทธิ์

การเข้าถึงที่เหมาะสม

ขอบเขต Meet Media API

ขอบเขตการให้สิทธิ์คือสิทธิ์ที่คุณขอให้ผู้ใช้ให้สิทธิ์แอปของคุณในการเข้าถึงเนื้อหาการประชุม เมื่อมีคนติดตั้งแอป ระบบจะขอให้ผู้ใช้ตรวจสอบขอบเขตเหล่านี้ โดยทั่วไป คุณควรเลือกขอบเขตที่แคบที่สุดเท่าที่จะเป็นไปได้ และหลีกเลี่ยงการขอขอบเขตที่แอปไม่จำเป็นต้องใช้ ผู้ใช้จะให้สิทธิ์เข้าถึงขอบเขตที่จำกัดและอธิบายไว้อย่างชัดเจนได้ง่ายกว่า

Meet Media API รองรับขอบเขต OAuth 2.0 ต่อไปนี้

รหัสขอบเขต คำอธิบาย การใช้งาน
https://www.googleapis.com/auth/meetings.conference.media.readonly บันทึกวิดีโอและเสียงแบบเรียลไทม์ในวิดีโอคอลของ Google Meet จำกัด
https://www.googleapis.com/auth/meetings.conference.media.audio.readonly บันทึกเสียงแบบเรียลไทม์ในวิดีโอคอลของ Google Meet จำกัด
https://www.googleapis.com/auth/meetings.conference.media.video.readonly บันทึกวิดีโอแบบเรียลไทม์ในวิดีโอคอลของ Google Meet จำกัด

เนื่องจากการประชุมเป็นข้อมูลที่ละเอียดอ่อน ขอบเขต Meet Media API ทั้งหมดจึงถูกจำกัด

นอกจากขอบเขต Meet Media API แล้ว คุณยังต้องขอขอบเขตการอ่านการประชุมทั่วไปด้วย OAuth ขอบเขตนี้จำเป็นสำหรับการเข้าถึงข้อมูลเมตาของการประชุม เช่น ข้อมูลผู้เข้าร่วมและรายการสื่อ รวมถึงการเจรจาการเชื่อมต่อที่สำเร็จ

รหัสขอบเขต คำอธิบาย การใช้งาน
https://www.googleapis.com/auth/meetings.space.read อนุญาตให้แอปอ่านข้อมูลเมตาเกี่ยวกับพื้นที่การประชุมที่ผู้ใช้มีสิทธิ์เข้าถึง ละเอียดอ่อน

หากแอปของคุณต้องเข้าถึง Google APIs อื่นๆ คุณก็เพิ่มขอบเขตเหล่านั้นได้เช่นกัน ดูข้อมูลเพิ่มเติมเกี่ยวกับขอบเขต Google API ได้ที่หัวข้อ การใช้ OAuth 2.0 เพื่อ เข้าถึง Google APIs

หากต้องการกำหนดข้อมูลที่จะแสดงต่อผู้ใช้และผู้ตรวจสอบแอป โปรดดูหัวข้อ กำหนดค่าหน้าจอขอความยินยอม OAuth และเลือก ขอบเขต

ดูข้อมูลเพิ่มเติมเกี่ยวกับขอบเขต OAuth 2.0 เฉพาะได้ที่หัวข้อขอบเขต OAuth 2.0 สำหรับ Google APIs

ข้อกำหนดสำหรับผู้ใช้ปลายทาง

หากต้องการใช้ Meet Media API ผู้เข้าร่วม Meet ต้องมีคุณสมบัติตรงตามข้อกำหนดขั้นต่ำบางประการด้วยเพื่อให้การประชุมมีสิทธิ์

เวอร์ชันแอปบนมือถือ

ผู้ใช้บนอุปกรณ์เคลื่อนที่ต้องอัปเดตเป็นเวอร์ชันต่อไปนี้

แพลตฟอร์ม แอป เวอร์ชัน
Android แอป Meet 309
iOS แอป Meet 308
Android แอป Gmail 2025.05.30
iOS แอป Gmail 6.0.250518

แพลตฟอร์มที่ไม่รองรับ

เราไม่รองรับไคลเอ็นต์ฮาร์ดแวร์ของบุคคลที่สามที่เรียกใช้ Meet เช่น หากผู้ใช้ปลายทางใช้อุปกรณ์ห้องประชุมฮาร์ดแวร์ของ Cisco ที่เรียกใช้ Meet อินสแตนซ์ Meet Media API ของคุณจะเข้าร่วมการโทรไม่ได้

ข้อจำกัดอายุ

Meet Media API ถูกจำกัดไม่ให้เก็บรวบรวมสื่อจากบัญชีที่ลงทะเบียนไว้กับผู้เยาว์

โดยปกติจะเป็นบัญชีของผู้ใช้ที่มีอายุต่ำกว่าอายุที่ให้ความยินยอมได้ในประเทศของตน (โดยทั่วไปคือต่ำกว่า 18 ปี) หรือมีอายุต่ำกว่าอายุที่ให้ความยินยอมได้เมื่อผู้ปกครองสร้างบัญชีในแอปพลิเคชัน Google Family Link

โปรดทราบว่าบางภูมิภาค (เช่น สหภาพยุโรป) มี ข้อจำกัดเพิ่มเติม เกี่ยวกับบัญชีประเภทใดที่ถือว่ามีอายุต่ำกว่าเกณฑ์

หากเชื่อว่าบัญชีของผู้ใช้รายใดรายหนึ่งถูกจำกัด คุณสามารถส่ง การยืนยันอายุ เพื่อตรวจสอบว่าบัญชีของผู้ใช้ได้รับการยืนยันอายุแล้วหรือไม่ ดูข้อมูลเพิ่มเติมเกี่ยวกับการยืนยันอายุ