เริ่มต้นใช้งาน 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 API คุณต้องเปิดใช้ API ในโปรเจ็กต์ Google Cloud คุณเปิด 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 อนุญาตให้แอปอ่านข้อมูลเมตาเกี่ยวกับพื้นที่การประชุมที่ผู้ใช้มีสิทธิ์เข้าถึง ละเอียดอ่อน

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

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

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

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

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

เวอร์ชันแอปบนอุปกรณ์เคลื่อนที่

สำหรับผู้ใช้มือถือ จะต้องอัปเดตเป็นเวอร์ชันต่อไปนี้

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

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

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

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

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

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

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

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