สังเกตกิจกรรมการประชุมด้วย Python และ Google Meet REST API

บทแนะนํานี้จะแสดงวิธีใช้ Google Meet REST API ร่วมกับ Google Workspace Events API และ Google Cloud Pub/Sub เพื่อสังเกตและตอบสนองต่อกิจกรรมการประชุม แอปพลิเคชันตัวอย่างจะบันทึกเมื่อการประชุมเริ่มต้นและสิ้นสุด เมื่อผู้เข้าร่วมเข้าร่วมหรือออกจากการประชุม และเมื่ออาร์ติแฟกต์การประชุมที่สร้างขึ้นพร้อมใช้งาน

หากต้องการดูข้อมูลเพิ่มเติมเกี่ยวกับการจัดการกิจกรรม โปรดดูหัวข้อสมัครกิจกรรมของ Google Meet ในเอกสาร Google Workspace Events API

ข้อกำหนดเบื้องต้น

หากต้องการให้องค์กรเปิดใช้ข้อกำหนดเบื้องต้นเหล่านี้ โปรดขอให้ผู้ดูแลระบบ Google Workspace เปิดใช้

• บัญชี Google Workspace ที่มีสิทธิ์เข้าถึง Google Meet
• สิทธิ์เข้าถึงเพื่อสร้างโปรเจ็กต์ Google Cloud
• ติดตั้ง Python 3 แล้ว
• gcloud CLI ติดตั้งแล้ว

เตรียมสภาพแวดล้อมของคุณ

ส่วนนี้จะแสดงวิธีสร้างและกำหนดค่าสภาพแวดล้อมภายในและโปรเจ็กต์ Google Cloud สำหรับบทแนะนำนี้

สร้างไดเรกทอรีการทำงานและสภาพแวดล้อมเสมือนของ Python

หากต้องการสร้างและเปิดใช้งานสภาพแวดล้อมเสมือนจริงใหม่ ให้เรียกใช้คำสั่งต่อไปนี้ในเทอร์มินัล

Linux/macOS

mkdir meet-tutorial
cd meet-tutorial
python3 -mvenv env
source env/bin/activate

Windows (พรอมต์คำสั่ง)

mkdir meet-tutorial
cd meet-tutorial
python3 -mvenv env
env/bin/activate.bat

Windows (PowerShell)

mkdir meet-tutorial
cd meet-tutorial
python3 -mvenv env
env/bin/activate.ps1

สร้างโปรเจ็กต์ Google Cloud

คอนโซล Google Cloud

1. ในคอนโซล Google Cloud ให้ไปที่เมนู > IAM และผู้ดูแลระบบ > สร้างโปรเจ็กต์

   ไปที่ "สร้างโปรเจ็กต์"

2. ในช่องชื่อโครงการ ให้ป้อนชื่อที่สื่อความหมายสำหรับโปรเจ็กต์ของคุณ

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

3. ในช่องตำแหน่ง ให้คลิกเรียกดูเพื่อแสดงตำแหน่งที่เป็นไปได้สำหรับโปรเจ็กต์ของคุณ จากนั้นคลิกเลือก
4. คลิกสร้าง คอนโซล Google Cloud จะไปที่หน้าแดชบอร์ดและระบบจะสร้างโปรเจ็กต์ขึ้นภายในไม่กี่นาที

gcloud CLI

เข้าถึง Google Cloud CLI (`gcloud`) ในสภาพแวดล้อมการพัฒนาซอฟต์แวร์ต่อไปนี้

• Cloud Shell: หากต้องการใช้เทอร์มินัลออนไลน์กับ gcloud CLI ที่ตั้งค่าไว้แล้ว ให้เปิดใช้งาน Cloud Shell
  เปิดใช้งาน Cloud Shell
• Local Shell: หากต้องการใช้สภาพแวดล้อมการพัฒนาภายใน ให้ติดตั้งและinitialize gcloud CLI
  หากต้องการสร้างโปรเจ็กต์ Cloud ให้ใช้คำสั่ง `gcloud project create`:

  gcloud projects create PROJECT_ID

  แทนที่ PROJECT_ID โดยตั้งค่ารหัสสำหรับโปรเจ็กต์ที่ต้องการสร้าง

เปิดใช้การเรียกเก็บเงินสำหรับโปรเจ็กต์ Google Cloud

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

คอนโซล Google Cloud

1. ในคอนโซล Google Cloud ให้ไปที่การเรียกเก็บเงิน คลิก เมนู > การเรียกเก็บเงิน > โปรเจ็กต์ของฉัน

   ไปที่การเรียกเก็บเงินสำหรับโปรเจ็กต์ของฉัน

2. ในส่วนเลือกองค์กร ให้เลือกองค์กรที่เชื่อมโยงกับโปรเจ็กต์ Google Cloud
3. ในแถวโปรเจ็กต์ ให้เปิดเมนูการดำเนินการ () คลิกเปลี่ยนการเรียกเก็บเงิน แล้วเลือกบัญชีสำหรับการเรียกเก็บเงินใน Cloud
4. คลิกตั้งค่าบัญชี

gcloud CLI

1. หากต้องการแสดงบัญชีสำหรับการเรียกเก็บเงินที่ใช้ได้ ให้เรียกใช้คำสั่งต่อไปนี้

   gcloud billing accounts list

2. ลิงก์บัญชีสำหรับการเรียกเก็บเงินกับโปรเจ็กต์ Google Cloud:

   gcloud billing projects link PROJECT_ID --billing-account=BILLING_ACCOUNT_ID

   แทนที่รายการต่อไปนี้

   • PROJECT_ID คือรหัสโปรเจ็กต์ของโปรเจ็กต์ที่อยู่ในระบบคลาวด์ที่คุณต้องการเปิดใช้การเรียกเก็บเงิน
   • BILLING_ACCOUNT_ID คือรหัสบัญชีสำหรับการเรียกเก็บเงินที่จะลิงก์กับโปรเจ็กต์ Google Cloud

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

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

กำหนดค่าหน้าจอขอความยินยอม OAuth และเลือกขอบเขต

ขั้นตอนต่อไปนี้จะแนะนำข้อมูลตัวยึดตำแหน่งเพื่อกำหนดค่าหน้าจอคำยินยอม OAuth สำหรับแอปของคุณ โปรดอัปเดตข้อมูลนี้ก่อนเผยแพร่แอปภายนอก

1. ในคอนโซล Google Cloud ให้ไปที่เมนู > API และบริการ > หน้าจอขอความยินยอม OAuth

   ไปที่หน้าจอขอความยินยอม OAuth

2. ในส่วนประเภทผู้ใช้ ให้เลือกภายใน แล้วคลิกสร้าง
   หากสร้างแอปภายในไม่ได้ ให้เลือกภายนอก
3. ในชื่อแอป ให้ป้อน Meet REST API Tutorial
4. กรอกแบบฟอร์มการลงทะเบียนแอปให้เสร็จสมบูรณ์ แล้วคลิกบันทึกและดำเนินการต่อ
5. คลิกเพิ่มหรือนำขอบเขตออก แผงจะปรากฏขึ้นพร้อมรายการขอบเขตของ API แต่ละรายการที่คุณเปิดใช้ในโปรเจ็กต์ Google Cloud
6. ในส่วนเพิ่มขอบเขตด้วยตนเอง ให้วางขอบเขตต่อไปนี้
   • https://www.googleapis.com/auth/meetings.space.created
7. คลิกเพิ่มลงในตาราง
8. คลิกอัปเดต
9. หลังจากเลือกขอบเขตที่แอปต้องการแล้ว ให้คลิกบันทึกและดำเนินการต่อ
10. หากเลือกภายนอกสำหรับประเภทผู้ใช้ ให้เพิ่มผู้ใช้ทดสอบดังนี้
    1. ในส่วนผู้ใช้ทดสอบ ให้คลิกเพิ่มผู้ใช้
    2. ป้อนอีเมลของคุณและผู้ใช้ทดสอบรายอื่นๆ ที่ได้รับอนุญาต แล้วคลิกบันทึกและต่อไป
11. ดูสรุปการลงทะเบียนแอป หากต้องการเปลี่ยนแปลง ให้คลิกแก้ไข หากการลงทะเบียนแอปถูกต้องแล้ว ให้คลิกกลับไปยังหน้าแดชบอร์ด

สร้างรหัสไคลเอ็นต์

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

1. ในคอนโซล Google Cloud ให้ไปที่เมนู > API และบริการ > ข้อมูลเข้าสู่ระบบ

   ไปที่ข้อมูลเข้าสู่ระบบ

2. คลิกสร้างข้อมูลเข้าสู่ระบบ > รหัสไคลเอ็นต์ OAuth
3. คลิกประเภทแอปพลิเคชัน > แอปบนเดสก์ท็อป
4. ในช่องชื่อ ให้พิมพ์ชื่อของข้อมูลเข้าสู่ระบบ ชื่อนี้จะแสดงในคอนโซล Google Cloud เท่านั้น
5. คลิกสร้าง หน้าจอที่สร้างของไคลเอ็นต์ OAuth จะปรากฏขึ้นเพื่อแสดงรหัสไคลเอ็นต์และรหัสลับไคลเอ็นต์ใหม่
6. คลิกตกลง ข้อมูลเข้าสู่ระบบที่สร้างขึ้นใหม่จะปรากฏในส่วนรหัสไคลเอ็นต์ OAuth 2.0

ติดตั้งไลบรารีการตรวจสอบสิทธิ์ของ Google

ติดตั้งไลบรารีการตรวจสอบสิทธิ์ของ Google โดยทำดังนี้

pip install google-auth google-auth-oauthlib

ดำเนินการให้สิทธิ์

Meet REST API ต้องใช้ข้อมูลเข้าสู่ระบบของผู้ใช้ในรูปแบบโทเค็นเพื่อการเข้าถึง OAuth 2.0 ในส่วนนี้ คุณจะใช้ขั้นตอน OAuth 2.0 เพื่อขอโทเค็นเพื่อการเข้าถึงและโทเค็นการรีเฟรชสำหรับผู้ใช้

1. ในไดเรกทอรีการทำงาน ให้สร้างไฟล์ main.py และเพิ่มเนื้อหาต่อไปนี้

   import os
   import json
   
   from google.auth.transport import requests
   from google.oauth2.credentials import Credentials
   from google_auth_oauthlib.flow import InstalledAppFlow
   
   def authorize() -> Credentials:
       """Ensure valid credentials for calling the Meet REST API."""
       CLIENT_SECRET_FILE = "./client_secret.json"
       credentials = None
   
       if os.path.exists('token.json'):
           credentials = Credentials.from_authorized_user_file('token.json')
   
       if credentials is None:
           flow = InstalledAppFlow.from_client_secrets_file(
               CLIENT_SECRET_FILE,
               scopes=[
                   'https://www.googleapis.com/auth/meetings.space.created',
               ])
           flow.run_local_server(port=0)
           credentials = flow.credentials
   
       if credentials and credentials.expired:
           credentials.refresh(requests.Request())
   
       if credentials is not None:
           with open("token.json", "w") as f:
               f.write(credentials.to_json())
   
       return credentials
   
   USER_CREDENTIALS = authorize()
   

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

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

   python3 main.py
   

เพิ่ม Meet REST API

ตอนนี้รหัสการให้สิทธิ์เสร็จสมบูรณ์แล้ว ให้เปิดใช้และเรียกใช้ Meet REST API

เปิดใช้ API

แม้ว่าส่วนนี้จะเน้นไปที่ Meet REST API แต่บทแนะนำนี้ยังใช้ Google Cloud Pub/Sub และ Google Workspace Events API ด้วย

คอนโซล Google Cloud

1. ในคอนโซล Google Cloud ให้เปิดใช้ Google Meet REST API, Google Workspace Events API และ Google Cloud Pub/Sub

   เปิดใช้ API

2. ยืนยันว่าคุณเปิดใช้ API ในโปรเจ็กต์ที่อยู่ในระบบคลาวด์ที่ถูกต้อง แล้วคลิกถัดไป

3. ยืนยันว่าคุณเปิดใช้ API ที่ถูกต้อง แล้วคลิกเปิดใช้

gcloud CLI

1. หากจำเป็น ให้ตั้งค่าโปรเจ็กต์ Cloud ปัจจุบันเป็นโปรเจ็กต์ที่คุณสร้างด้วยคำสั่ง gcloud config set project ดังนี้

   gcloud config set project PROJECT_ID
   

   แทนที่ PROJECT_ID ด้วยรหัสโปรเจ็กต์ของโปรเจ็กต์ระบบคลาวด์ที่คุณสร้าง

2. เปิดใช้ Google Meet REST API, Google Workspace Events API และ Google Cloud Pub/Sub ด้วยคำสั่ง gcloud services enable ดังนี้

   gcloud services enable meet.googleapis.com workspaceevents.googleapis.com pubsub.googleapis.com
   

ติดตั้งไลบรารีของไคลเอ็นต์ Meet REST API

โปรดทำตามขั้นตอนต่อไปนี้เพื่อติดตั้งไลบรารีของไคลเอ็นต์ Meet REST API

1. เรียกใช้คำสั่งต่อไปนี้

   pip install google-apps-meet
   

2. แก้ไขไฟล์ main.py เพื่อนําเข้าไคลเอ็นต์

   from google.apps import meet_v2 as meet
   

สร้างพื้นที่ทำงาน

เมื่อ Meet REST API พร้อมให้ใช้งานแล้ว ให้กำหนดฟังก์ชันเพื่อสร้างพื้นที่การประชุมที่สมัครใช้บริการได้

แก้ไข main.py และเพิ่ม:

def create_space() -> meet.Space:
    """Create a meeting space."""
    client = meet.SpacesServiceClient(credentials=USER_CREDENTIALS)
    request = meet.CreateSpaceRequest()
    return client.create_space(request=request)

สมัครรับข้อมูลกิจกรรม

หากต้องการรับกิจกรรมเกี่ยวกับพื้นที่ประชุม ให้สร้างการสมัครใช้บริการโดยใช้ Google Workspace Events API คุณต้องสร้างและสมัครรับข้อมูลหัวข้อ Google Cloud Pub/Sub ซึ่งทำหน้าที่เป็นปลายทางการแจ้งเตือนที่แอปของคุณได้รับเหตุการณ์

กำหนดค่า Google Cloud Pub/Sub

วิธีสร้างและสมัครรับข้อมูลหัวข้อ Pub/Sub

คอนโซล Google Cloud

1. ในคอนโซล Google Cloud ให้ไปที่เมนู > Pub/Sub

   ไปที่ Pub/Sub

   ตรวจสอบว่าได้เลือกโปรเจ็กต์ที่อยู่ในระบบคลาวด์สำหรับแอปแล้ว

2. คลิก สร้างหัวข้อ แล้วทำดังต่อไปนี้
   1. ป้อน workspace-events เป็นชื่อหัวข้อ
   2. เลือกเพิ่มการสมัครใช้บริการเริ่มต้นไว้
   3. คลิกสร้าง ชื่อหัวข้อแบบเต็มจะอยู่ในรูปแบบ projects/{project}/topics/{topic} จดชื่อนี้ไว้เพื่อใช้ในขั้นตอนถัดไป
3. ให้สิทธิ์เข้าถึงเพื่อเผยแพร่ข้อความ Pub/Sub ในหัวข้อของคุณ
   1. ในแผงด้านข้าง ให้เปิดแท็บสิทธิ์
   2. คลิกเพิ่มผู้ใช้หลัก
   3. ในผู้ใช้หลักรายใหม่ ให้ป้อน [e-mail]
   4. ในส่วนมอบหมายบทบาท ให้เลือก Pub/Sub Publisher
   5. คลิกบันทึก

   ระบบอาจใช้เวลาสักครู่ในการอัปเดตสิทธิ์สำหรับหัวข้อของคุณ

gcloud CLI

1. ในโปรเจ็กต์ Cloud ให้สร้างหัวข้อโดยการเรียกใช้รายการต่อไปนี้

   gcloud pubsub topics create workspace-events

   เอาต์พุตจะแสดงชื่อหัวข้อแบบเต็มในรูปแบบ projects/{project}/topics/{topic} จดชื่อนี้ไว้เพื่อใช้ในขั้นตอนถัดไป

2. ให้สิทธิ์เข้าถึงเพื่อเผยแพร่ข้อความในหัวข้อของคุณ:

    gcloud pubsub topics add-iam-policy-binding workspace-events --member='serviceAccount:[e-mail]' --role='roles/pubsub.publisher'

   ระบบอาจใช้เวลาสักครู่ในการอัปเดตสิทธิ์สำหรับหัวข้อของคุณ

3. สร้างการสมัครใช้บริการ Pub/Sub สำหรับหัวข้อ:

   gcloud pubsub subscriptions create workspace-events-sub --topic=TOPIC_NAME

   แทนที่รายการต่อไปนี้

   • TOPIC_NAME: ชื่อหัวข้อที่คุณสร้างในขั้นตอนก่อนหน้า

จดชื่อหัวข้อไว้และตรวจสอบว่าค่าของ {project} คือรหัสโปรเจ็กต์ที่อยู่ในระบบคลาวด์ของแอป คุณจะใช้ชื่อหัวข้อเพื่อสร้างการสมัครใช้บริการ Google Workspace ในภายหลัง

สร้างบัญชีบริการ

คอนโซล Google Cloud

1. ในคอนโซล Google Cloud ให้ไปที่เมนู > IAM และผู้ดูแลระบบ > บัญชีบริการ

   ไปที่บัญชีบริการ

2. คลิกสร้างบัญชีบริการ
3. กรอกรายละเอียดบัญชีบริการ แล้วคลิกสร้างและต่อไป
   หมายเหตุ: โดยค่าเริ่มต้น Google จะสร้างรหัสบัญชีบริการที่ไม่ซ้ำกัน หากต้องการเปลี่ยนรหัส ให้แก้ไขรหัสในช่องรหัสบัญชีบริการ
4. ไม่บังคับ: กำหนดบทบาทให้กับบัญชีบริการเพื่อให้สิทธิ์เข้าถึงทรัพยากรของโปรเจ็กต์ Google Cloud โปรดดูรายละเอียดเพิ่มเติมในการให้ การเปลี่ยนแปลง และการเพิกถอนสิทธิ์เข้าถึงทรัพยากร
5. คลิกต่อไป
6. ไม่บังคับ: ป้อนผู้ใช้หรือกลุ่มที่จัดการและดำเนินการด้วยบัญชีบริการนี้ได้ โปรดดูรายละเอียดเพิ่มเติมที่หัวข้อการจัดการการแอบอ้างเป็นบัญชีบริการ
7. คลิกเสร็จ จดบันทึกอีเมลสำหรับบัญชีบริการ

gcloud CLI

1. สร้างบัญชีบริการ:

   gcloud iam service-accounts create meet-event-listener \
     --display-name="meet-event-listener"

2. ไม่บังคับ: กำหนดบทบาทให้กับบัญชีบริการเพื่อให้สิทธิ์เข้าถึงทรัพยากรของโปรเจ็กต์ Google Cloud โปรดดูรายละเอียดเพิ่มเติมในการให้ การเปลี่ยนแปลง และการเพิกถอนสิทธิ์เข้าถึงทรัพยากร

ใช้บัญชีบริการ

หลังจากสร้างบัญชีบริการแล้ว โปรดให้สิทธิ์ตนเองเพื่อแอบอ้างบัญชีบริการ

คอนโซล Google Cloud

1. ในคอลัมน์การดำเนินการสำหรับบัญชีบริการที่สร้างขึ้นใหม่ ให้คลิก > จัดการสิทธิ์
2. คลิกเพิ่มคีย์ > ให้สิทธิ์เข้าถึง
3. ป้อนอีเมลของคุณในส่วนเพิ่มผู้ใช้หลัก
4. เลือกบัญชีบริการ > ผู้สร้างโทเค็นบัญชีบริการเป็นบทบาท
5. คลิกบันทึก

gcloud CLI

1. หากต้องการเพิ่มสิทธิ์ ให้เรียกใช้ gcloud iam service-accounts add-iam-policy-binding โดยใช้อีเมลของบัญชีบริการและผู้ใช้

   gcloud iam service-accounts add-iam-policy-binding \
     SERVICE_ACCOUNT_EMAIL \
     --member="user:YOUR_EMAIL \
     --role="roles/iam.serviceAccountTokenCreator"

2. ลงชื่อเข้าใช้ด้วย gcloud เพื่อตั้งค่าข้อมูลเข้าสู่ระบบเริ่มต้นของแอปพลิเคชันเป็นบัญชีบริการ เมื่อได้รับข้อความแจ้งให้ให้สิทธิ์ ให้ลงชื่อเข้าใช้ด้วยบัญชีเดียวกับที่ใช้ในขั้นตอนก่อนหน้า

   gcloud auth application-default login --impersonate-service-account=SERVICE_ACCOUNT_EMAIL

ติดตั้งไลบรารีของไคลเอ็นต์ Pub/Sub

1. ใช้ pip เพื่อติดตั้งไลบรารีไคลเอ็นต์สำหรับ Pub/Sub ดังนี้

   pip install google-cloud-pubsub
   

2. จากนั้นแก้ไข main.py เพื่อนําเข้าไคลเอ็นต์

   from google.cloud import pubsub_v1
   

สร้างการสมัครใช้บริการ Google Workspace

เพิ่มโค้ดต่อไปนี้ลงใน main.py เพื่อกำหนดวิธีการสมัครรับข้อมูลกิจกรรมใน Meet รหัสนี้ใช้สำหรับเหตุการณ์ทั้งหมดในพื้นที่การประชุม เมื่อสมัครรับข้อมูลแล้ว ระบบจะโพสต์กิจกรรมไปยังหัวข้อ Pub/Sub

def subscribe_to_space(space_name: str = None, topic_name: str = None):
    """Subscribe to events for a meeting space."""
    session = requests.AuthorizedSession(USER_CREDENTIALS)
    body = {
        'targetResource': f"//meet.googleapis.com/{space_name}",
        "eventTypes": [
            "google.workspace.meet.conference.v2.started",
            "google.workspace.meet.conference.v2.ended",
            "google.workspace.meet.participant.v2.joined",
            "google.workspace.meet.participant.v2.left",
            "google.workspace.meet.recording.v2.fileGenerated",
            "google.workspace.meet.transcript.v2.fileGenerated",
        ],
        "payloadOptions": {
            "includeResource": False,
        },
        "notificationEndpoint": {
            "pubsubTopic": topic_name
        },
        "ttl": "86400s",
    }
    response = session.post("https://workspaceevents.googleapis.com/v1/subscriptions", json=body)
    return response

จากนั้น เพิ่มโค้ดที่เกี่ยวข้องเพื่อดึงและประมวลผลเหตุการณ์

ฟังและจัดการกิจกรรม

แก้ไข main.py ต่อไปและเพิ่มโค้ดตัวอย่างต่อไปนี้ โค้ดนี้จะนําฝั่งผู้รับไปใช้และใช้ Google Cloud Pub/Sub API เพื่อดึงเหตุการณ์ตามที่สร้างขึ้นมา วิธีการต่างๆ ของเครื่องจัดการจะพิมพ์ข้อมูลเกี่ยวกับ เหตุการณ์ที่เกี่ยวข้อง

def format_participant(participant: meet.Participant) -> str:
    """Formats a participant for display on the console."""
    if participant.anonymous_user:
        return f"{participant.anonymous_user.display_name} (Anonymous)"

    if participant.signedin_user:
        return f"{participant.signedin_user.display_name} (ID: {participant.signedin_user.user})"

    if participant.phone_user:
        return f"{participant.phone_user.display_name} (Phone)"

    return "Unknown participant"


def fetch_participant_from_session(session_name: str) -> meet.Participant:
    """Fetches the participant for a session."""
    client = meet.ConferenceRecordsServiceClient(credentials=USER_CREDENTIALS)
    # Use the parent path of the session to fetch the participant details
    parsed_session_path = client.parse_participant_session_path(session_name)
    participant_resource_name = client.participant_path(
        parsed_session_path["conference_record"],
        parsed_session_path["participant"])
    return client.get_participant(name=participant_resource_name)


def on_conference_started(message: pubsub_v1.subscriber.message.Message):
    """Display information about a conference when started."""
    payload = json.loads(message.data)
    resource_name = payload.get("conferenceRecord").get("name")
    client = meet.ConferenceRecordsServiceClient(credentials=USER_CREDENTIALS)
    conference = client.get_conference_record(name=resource_name)
    print(f"Conference (ID {conference.name}) started at {conference.start_time.rfc3339()}")


def on_conference_ended(message: pubsub_v1.subscriber.message.Message):
    """Display information about a conference when ended."""
    payload = json.loads(message.data)
    resource_name = payload.get("conferenceRecord").get("name")
    client = meet.ConferenceRecordsServiceClient(credentials=USER_CREDENTIALS)
    conference = client.get_conference_record(name=resource_name)
    print(f"Conference (ID {conference.name}) ended at {conference.end_time.rfc3339()}")


def on_participant_joined(message: pubsub_v1.subscriber.message.Message):
    """Display information about a participant when they join a meeting."""
    payload = json.loads(message.data)
    resource_name = payload.get("participantSession").get("name")
    client = meet.ConferenceRecordsServiceClient(credentials=USER_CREDENTIALS)
    session = client.get_participant_session(name=resource_name)
    participant = fetch_participant_from_session(resource_name)
    display_name = format_participant(participant)
    print(f"{display_name} joined at {session.start_time.rfc3339()}")


def on_participant_left(message: pubsub_v1.subscriber.message.Message):
    """Display information about a participant when they leave a meeting."""
    payload = json.loads(message.data)
    resource_name = payload.get("participantSession").get("name")
    client = meet.ConferenceRecordsServiceClient(credentials=USER_CREDENTIALS)
    session = client.get_participant_session(name=resource_name)
    participant = fetch_participant_from_session(resource_name)
    display_name = format_participant(participant)
    print(f"{display_name} left at {session.end_time.rfc3339()}")


def on_recording_ready(message: pubsub_v1.subscriber.message.Message):
    """Display information about a recorded meeting when artifact is ready."""
    payload = json.loads(message.data)
    resource_name = payload.get("recording").get("name")
    client = meet.ConferenceRecordsServiceClient(credentials=USER_CREDENTIALS)
    recording = client.get_recording(name=resource_name)
    print(f"Recording available at {recording.drive_destination.export_uri}")


def on_transcript_ready(message: pubsub_v1.subscriber.message.Message):
    """Display information about a meeting transcript when artifact is ready."""
    payload = json.loads(message.data)
    resource_name = payload.get("transcript").get("name")
    client = meet.ConferenceRecordsServiceClient(credentials=USER_CREDENTIALS)
    transcript = client.get_transcript(name=resource_name)
    print(f"Transcript available at {transcript.docs_destination.export_uri}")


def on_message(message: pubsub_v1.subscriber.message.Message) -> None:
    """Handles an incoming event from the Google Cloud Pub/Sub API."""
    event_type = message.attributes.get("ce-type")
    handler = {
        "google.workspace.meet.conference.v2.started": on_conference_started,
        "google.workspace.meet.conference.v2.ended": on_conference_ended,
        "google.workspace.meet.participant.v2.joined": on_participant_joined,
        "google.workspace.meet.participant.v2.left": on_participant_left,
        "google.workspace.meet.recording.v2.fileGenerated": on_recording_ready,
        "google.workspace.meet.transcript.v2.fileGenerated": on_transcript_ready,
    }.get(event_type)

    try:
        if handler is not None:
            handler(message)
        message.ack()
    except Exception as error:
        print("Unable to process event")
        print(error)


def listen_for_events(subscription_name: str = None):
    """Subscribe to events on the subscription."""
    subscriber = pubsub_v1.SubscriberClient()
    with subscriber:
        future = subscriber.subscribe(subscription_name, callback=on_message)
        print("Listening for events")
        try:
            future.result()
        except KeyboardInterrupt:
            future.cancel()
    print("Done")

เขียนโค้ดให้เสร็จ

เพิ่มโค้ดต่อไปนี้ลงใน main.py เพื่อเรียกใช้เมธอดในการสร้างพื้นที่ทำงาน สมัครรับข้อมูลกิจกรรม และฟัง อัปเดตค่าคงที่ TOPIC_NAME และ SUBSCRIPTION_NAME ด้วยชื่อหัวข้อและการสมัครใช้บริการของคุณเองที่คุณสร้างไว้ก่อนหน้านี้

1. เพิ่มโค้ดลงใน main.py:

   space = create_space()
   print(f"Join the meeting at {space.meeting_uri}")
   
   TOPIC_NAME = "projects/PROJECT_ID/topics/TOPIC_ID"
   SUBSCRIPTION_NAME = "projects/PROJECT_ID/subscriptions/SUBSCRIPTION_ID"
   
   subscription = subscribe_to_space(topic_name=TOPIC_NAME, space_name=space.name)
   listen_for_events(subscription_name=SUBSCRIPTION_NAME)
   

   แทนที่รายการต่อไปนี้

   • PROJECT_ID: รหัสโปรเจ็กต์ Cloud ที่ไม่ซ้ำกันสำหรับแอปของคุณ เช่น my-sample-project-191923

   • TOPIC_ID: ชื่อของหัวข้อ Pub/Sub ที่คุณสร้างในโปรเจ็กต์ที่อยู่ในระบบคลาวด์

   • SUBSCRIPTION_ID: ชื่อของการสมัครใช้บริการ เช่น workspace-events-sub

2. เรียกใช้โปรแกรม

   python3 main.py
   

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

Join the meeting at https://meet.google.com/abc-mnop-xyz

เข้าร่วมการประชุม

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

• ออกและเข้าร่วมการประชุมอีกครั้ง
• เชิญผู้อื่นหรือโทรเข้าร่วมด้วยโทรศัพท์
• เปิดใช้การบันทึกและข้อความถอดเสียง

แต่ละกิจกรรมเหล่านี้จะสร้างเหตุการณ์ที่แอปพลิเคชันได้รับและบันทึกคอนโซล Google Cloud

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

ใช้ ctrl-c เพื่อขัดจังหวะรายการเมื่อดำเนินการเสร็จสิ้น

ไม่บังคับ: ขั้นตอนเพิ่มเติม

แอปจะบันทึกรายละเอียดพื้นฐานเกี่ยวกับเหตุการณ์ หากต้องการสำรวจ Meet REST API ต่อไป ให้ลองแก้ไขแอปพลิเคชันเพื่อดำเนินการเพิ่มเติมเหล่านี้

• ใช้ People API เพื่อเรียกดูข้อมูลเพิ่มเติมเกี่ยวกับผู้เข้าร่วมที่ลงชื่อเข้าใช้
• ใช้ Google Drive API เพื่อดาวน์โหลดการบันทึกและข้อความถอดเสียง
• เรียกดูข้อความถอดเสียงโดยใช้วิธีการถอดเสียงเป็นคำที่มีโครงสร้างใน Meet REST API แทนการดาวน์โหลดข้อความถอดเสียงจาก Google ไดรฟ์

ไม่บังคับ: ล้างข้อมูล

เราขอแนะนำให้คุณล้างทรัพยากรและโปรเจ็กต์ที่สร้างขึ้นเพื่อเลี่ยงไม่ให้เกิดการเรียกเก็บเงินกับบัญชีคอนโซล Google Cloud สำหรับทรัพยากรที่ใช้ในบทแนะนำนี้

วิธีลบการสมัครใช้บริการ

คอนโซล

1. ในคอนโซล Google Cloud ให้ไปที่เมนู > Pub/Sub > การสมัครใช้บริการ

   ไปที่การสมัครใช้บริการ

2. เลือกการสมัครใช้บริการ แล้วคลิกการดำเนินการเพิ่มเติม

3. คลิกลบ หน้าต่างลบการสมัครใช้บริการจะปรากฏขึ้น

4. คลิกลบ

gcloud CLI

1. ลบการสมัครใช้บริการ

   gcloud pubsub subscriptions delete SUBSCRIPTION_NAME
   

วิธีลบหัวข้อ

คอนโซล

1. ในคอนโซล Google Cloud ให้ไปที่เมนู > Pub/Sub > หัวข้อ

   ไปที่หัวข้อ

2. เลือกหัวข้อแล้วคลิกการดำเนินการเพิ่มเติม

3. คลิกลบ หน้าต่างลบหัวข้อจะปรากฏขึ้น

4. ป้อน delete แล้วคลิกลบ

gcloud CLI

1. ลบหัวข้อ:

   gcloud pubsub topics delete TOPIC_NAME
   

หากต้องการลบโปรเจ็กต์ ให้ทำดังนี้

คอนโซล

ข้อควรระวัง: การลบโปรเจ็กต์จะมีผลกระทบดังต่อไปนี้

• ระบบจะลบทุกอย่างในโปรเจ็กต์ หากใช้โปรเจ็กต์ที่มีอยู่สำหรับบทแนะนำนี้ เมื่อคุณลบโปรเจ็กต์ จะเป็นการลบงานอื่นๆ ที่คุณทำในโปรเจ็กต์ด้วย
• รหัสโปรเจ็กต์ที่กำหนดเองจะหายไป เมื่อสร้างโปรเจ็กต์นี้ คุณอาจได้สร้างรหัสโปรเจ็กต์ที่กำหนดเองซึ่งต้องการใช้ในอนาคต หากต้องการเก็บ URL ที่ใช้รหัสโปรเจ็กต์ไว้ เช่น URL ใน appspot.com ให้ลบทรัพยากรที่เลือกภายในโปรเจ็กต์แทนการลบทั้งโปรเจ็กต์

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

1. ในคอนโซล Google Cloud ให้ไปที่หน้าจัดการทรัพยากร คลิก เมนู > IAM และผู้ดูแลระบบ > จัดการทรัพยากร

   ไปที่เครื่องมือจัดการทรัพยากร

2. ในรายการโปรเจ็กต์ ให้เลือกโปรเจ็กต์ที่ต้องการลบ แล้วคลิกลบ
3. ในกล่องโต้ตอบ ให้พิมพ์รหัสโปรเจ็กต์แล้วคลิกปิดเพื่อลบโปรเจ็กต์

gcloud CLI

1. หากต้องการลบโปรเจ็กต์ ให้ใช้คำสั่ง gcloud project delete:

   gcloud projects delete PROJECT_ID
   

หัวข้อที่เกี่ยวข้อง

• ดูข้อมูลเพิ่มเติมเกี่ยวกับสิ่งที่ Google Meet REST API ทำได้และเอกสารอ้างอิง
• อ่านวิธีสมัครรับข้อมูลกิจกรรมโดยใช้ Google Workspace Events API
• ดูข้อมูลเพิ่มเติมเกี่ยวกับการตรวจสอบสิทธิ์ได้ที่หัวข้อกำหนดค่าหน้าจอคำยินยอม OAuth และเลือกขอบเขต