Python और Google Meet REST API की मदद से, मीटिंग इवेंट देखें

इस ट्यूटोरियल में बताया गया है कि मीटिंग इवेंट पर नज़र रखने और उन पर प्रतिक्रिया देने के लिए, Google Workspace इवेंट एपीआई और Google Cloud Pub/Sub के साथ-साथ, Google Meet REST API का इस्तेमाल कैसे करें. सैंपल ऐप्लिकेशन, कॉन्फ़्रेंस के शुरू और खत्म होने, मीटिंग में हिस्सा लेने वाले लोगों के शामिल होने या छोड़ने, और मीटिंग से जुड़ा कोई भी आर्टफ़ैक्ट उपलब्ध होने पर रिकॉर्ड करता है.

इवेंट पर काम करने के बारे में ज़्यादा जानने के लिए, Google Workspace इवेंट एपीआई दस्तावेज़ में Google Meet इवेंट की सदस्यता लें लेख पढ़ें.

ज़रूरी शर्तें

अगर आपको अपने संगठन के लिए, इनमें से कोई भी ज़रूरी शर्त चालू करनी है, तो अपने Google Workspace एडमिन से इन्हें चालू करने के लिए कहें:

अपने आस-पास के माहौल को तैयार करें

इस सेक्शन में, इस ट्यूटोरियल के लिए अपना लोकल एनवायरमेंट और 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 Console में, मेन्यू > IAM और एडमिन > प्रोजेक्ट बनाएं पर जाएं.

    'प्रोजेक्ट बनाएं' पर जाएं

  2. प्रोजेक्ट का नाम फ़ील्ड में, अपने प्रोजेक्ट के लिए जानकारी देने वाला नाम डालें.

    ज़रूरी नहीं: प्रोजेक्ट आईडी में बदलाव करने के लिए बदलाव करें पर क्लिक करें. प्रोजेक्ट बनाने के बाद, प्रोजेक्ट आईडी नहीं बदला जा सकता. इसलिए, ऐसा आईडी चुनें जो आपके प्रोजेक्ट के लिए हमेशा ज़रूरी हो.

  3. अपने प्रोजेक्ट की संभावित जगहें देखने के लिए, जगह फ़ील्ड में ब्राउज़ करें पर क्लिक करें. इसके बाद, चुनें पर क्लिक करें.
  4. बनाएं पर क्लिक करें. Google Cloud Console, डैशबोर्ड पेज पर जाता है और कुछ ही मिनटों में आपका प्रोजेक्ट बन जाता है.

gcloud सीएलआई

इनमें से किसी एक डेवलपमेंट एनवायरमेंट में, Google Cloud सीएलआई (`gcloud`) को ऐक्सेस करें:

  • Cloud Shell: पहले से सेट अप किए गए gcloud सीएलआई के साथ ऑनलाइन टर्मिनल का इस्तेमाल करने के लिए, Cloud Shell को चालू करें.
    Cloud Shell चालू करें
  • लोकल शेल: लोकल डेवलपमेंट एनवायरमेंट का इस्तेमाल करने के लिए, gcloud सीएलआई को इंस्टॉल करें और initialize.
    क्लाउड प्रोजेक्ट बनाने के लिए, `gcloud projects create`कमांड का इस्तेमाल करें: 
    gcloud projects create PROJECT_ID
    आपको जो प्रोजेक्ट बनाना है उसका आईडी सेट करके, PROJECT_ID को बदलें.

Google Cloud प्रोजेक्ट के लिए बिलिंग की सुविधा चालू करें

Google Cloud कंसोल

  1. Google Cloud Console में, बिलिंग पर जाएं. मेन्यू > बिलिंग > मेरे प्रोजेक्ट पर क्लिक करें.

    मेरे प्रोजेक्ट के लिए बिलिंग पर जाएं

  2. संगठन चुनें में जाकर, अपने Google Cloud प्रोजेक्ट से जुड़ा संगठन चुनें.
  3. प्रोजेक्ट की लाइन में, कार्रवाई मेन्यू () खोलें. बिलिंग बदलें पर क्लिक करें और क्लाउड बिलिंग खाता चुनें.
  4. खाता सेट करें पर क्लिक करें.

gcloud सीएलआई

  1. उपलब्ध बिलिंग खातों की सूची बनाने के लिए, इसे चलाएं: 
    gcloud billing accounts list
  2. Google Cloud प्रोजेक्ट के साथ बिलिंग खाता जोड़ें: 
    gcloud billing projects link PROJECT_ID --billing-account=BILLING_ACCOUNT_ID

    इन्हें बदलें:

    • PROJECT_ID, उस Cloud प्रोजेक्ट का प्रोजेक्ट आईडी है जिसके लिए आपको बिलिंग की सुविधा चालू करनी है.
    • Google Cloud प्रोजेक्ट से लिंक करने के लिए, BILLING_ACCOUNT_ID बिलिंग खाता आईडी है.

पुष्टि करने और अनुमति देने की सुविधा सेट अप करना

पुष्टि करने और अनुमति देने से ऐप्लिकेशन, Meet REST API संसाधनों को ऐक्सेस कर पाता है. Meet REST API को कॉल करने के लिए, उपयोगकर्ता की अनुमति ज़रूरी है. इस सेक्शन में, उपयोगकर्ता के क्रेडेंशियल कॉन्फ़िगर करने और अनुमति का अनुरोध करने का तरीका बताया गया है.

ऐसी स्क्रीन को कॉन्फ़िगर करना जहां OAuth के लिए सहमति दी जाती है और स्कोप चुनें

आपके ऐप्लिकेशन के लिए OAuth की सहमति वाली स्क्रीन को कॉन्फ़िगर करने के लिए, यहां दिया गया तरीका प्लेसहोल्डर की जानकारी का सुझाव देता है. ऐप्लिकेशन को बाहर से पब्लिश करने से पहले, इस जानकारी को अपडेट करें.

  1. Google Cloud Console में, मेन्यू > एपीआई और सेवाएं > OAuth की सहमति वाली स्क्रीन पर जाएं.

    ऐसी स्क्रीन पर जाएं जहां OAuth के लिए सहमति दी जाती है

  2. उपयोगकर्ता टाइप में जाकर, इंटरनल चुनें. इसके बाद, बनाएं पर क्लिक करें.
  3. ऐप्लिकेशन का नाम में, Meet REST API Tutorial डालें.
  4. ऐप्लिकेशन रजिस्ट्रेशन फ़ॉर्म भरें. इसके बाद, सेव करें और जारी रखें पर क्लिक करें.
  5. स्कोप जोड़ें या हटाएं पर क्लिक करें. आपको एक पैनल दिखेगा जिसमें हर उस एपीआई के स्कोप की सूची होगी जिसे आपने Google Cloud प्रोजेक्ट में चालू किया है.
  6. मैन्युअल तरीके से स्कोप जोड़ें में जाकर, ये स्कोप चिपकाएं:
    • https://www.googleapis.com/auth/meetings.space.created
  7. टेबल में जोड़ें पर क्लिक करें.
  8. अपडेट करें पर क्लिक करें.
  9. अपने ऐप्लिकेशन के लिए ज़रूरी दायरों को चुनने के बाद, सेव करें और जारी रखें पर क्लिक करें.
  10. अगर आपने उपयोगकर्ता टाइप के लिए बाहरी उपयोगकर्ता को चुना है, तो टेस्ट उपयोगकर्ताओं को जोड़ें:
    1. टेस्ट उपयोगकर्ता में जाकर, उपयोगकर्ताओं को जोड़ें पर क्लिक करें.
    2. अपना ईमेल पता और टेस्ट के लिए अनुमति पा चुके किसी अन्य उपयोगकर्ता का ईमेल पता डालें. इसके बाद, सेव करें और जारी रखें पर क्लिक करें.
  11. अपने ऐप्लिकेशन रजिस्ट्रेशन की खास जानकारी देखें. बदलाव करने के लिए, बदलाव करें पर क्लिक करें. अगर ऐप्लिकेशन रजिस्ट्रेशन ठीक लग रहा है, तो डैशबोर्ड पर वापस जाएं पर क्लिक करें.

क्लाइंट आईडी बनाना

OAuth 2.0 फ़्लो के दौरान, क्लाइंट आईडी आपके ऐप्लिकेशन के लिए क्रेडेंशियल के तौर पर काम करता है. ऐप्लिकेशन स्थानीय डिवाइस पर ही काम करता है, इसलिए डेस्कटॉप क्लाइंट आईडी बनाएं.

  1. Google Cloud Console में, मेन्यू > एपीआई और सेवाएं > क्रेडेंशियल पर जाएं.

    क्रेडेंशियल पर जाएं

  2. क्रेडेंशियल बनाएं > OAuth क्लाइंट आईडी पर क्लिक करें.
  3. ऐप्लिकेशन प्रकार > डेस्कटॉप ऐप्लिकेशन पर क्लिक करें.
  4. नाम फ़ील्ड में, क्रेडेंशियल के लिए नाम लिखें. यह नाम सिर्फ़ Google Cloud Console में दिखता है.
  5. बनाएं पर क्लिक करें. अब OAuth क्लाइंट की स्क्रीन पर आपका नया क्लाइंट आईडी और क्लाइंट सीक्रेट दिखेगा.
  6. ठीक है पर क्लिक करें. नया क्रेडेंशियल, OAuth 2.0 Client ID में दिखता है.

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 को चालू करें और कॉल करें.

एपीआई चालू करें

इस सेक्शन का फ़ोकस Meet REST API पर होता है, लेकिन इस ट्यूटोरियल में Google Cloud Pub/Sub और Google Workspace इवेंट एपीआई का भी इस्तेमाल किया जाता है.

Google Cloud कंसोल

  1. Google Cloud Console में, Google Meet REST API, Google Workspace इवेंट एपीआई, और Google Cloud Pub/Sub को चालू करें.

    एपीआई चालू करें

  2. पक्का करें कि आपने सही Cloud प्रोजेक्ट में एपीआई चालू किए हैं. इसके बाद, आगे बढ़ें पर क्लिक करें.

  3. पक्का करें कि आपने सही एपीआई चालू किए हैं. इसके बाद, चालू करें पर क्लिक करें.

gcloud सीएलआई

  1. अगर ज़रूरी हो, तो मौजूदा Cloud प्रोजेक्ट को उस प्रोजेक्ट पर सेट करें जिसे आपने gcloud config set project कमांड की मदद से बनाया है:

    gcloud config set project PROJECT_ID

    PROJECT_ID की जगह, आपके बनाए गए Cloud प्रोजेक्ट के प्रोजेक्ट आईडी का इस्तेमाल करें.

  2. Google Meet REST API, Google Workspace इवेंट एपीआई, और 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 इवेंट एपीआई का इस्तेमाल करके सदस्यता बनानी होगी. आपको Google Cloud Pub/Sub विषय बनाना और उसकी सदस्यता भी लेनी होगी. यह विषय सूचना के एंडपॉइंट के तौर पर काम करता है, जहां आपके ऐप्लिकेशन को इवेंट मिलते हैं.

Google Cloud Pub/Sub को कॉन्फ़िगर करना

कोई Pub/Sub विषय बनाने और उसकी सदस्यता लेने के लिए:

Google Cloud कंसोल

  1. Google Cloud Console में, मेन्यू > Pub/Sub पर जाएं.

    Pub/Sub पर जाएं

    पक्का करें कि आपके ऐप्लिकेशन के लिए क्लाउड प्रोजेक्ट चुना गया हो.

  2. विषय बनाएं पर क्लिक करें और ये काम करें:
    1. विषय के नाम के तौर पर workspace-events डालें.
    2. डिफ़ॉल्ट सदस्यता जोड़ें को चुना रहने दें.
    3. बनाएं पर क्लिक करें. आपके विषय का पूरा नाम projects/{project}/topics/{topic} के तौर पर फ़ॉर्मैट किया गया है. बाद के चरणों में इस्तेमाल करने के लिए, इस नाम का एक नोट बना लें.
  3. अपने विषय पर Pub/Sub मैसेज पब्लिश करने का ऐक्सेस दें:
    1. साइड पैनल में, अनुमतियां टैब खोलें.
    2. प्रिंसिपल जोड़ें पर क्लिक करें.
    3. प्रिंसिपल वाले नए सेक्शन में, meet-api-event-push@system.gserviceaccount.com डालें.
    4. भूमिकाएं असाइन करें में जाकर, Pub/Sub Publisher चुनें.
    5. सेव करें पर क्लिक करें.

    आपके विषय के लिए अनुमतियां अपडेट करने में कुछ मिनट लग सकते हैं.

gcloud सीएलआई

  1. अपने Cloud प्रोजेक्ट में, यह तरीका अपनाकर एक विषय बनाएं: 
    gcloud pubsub topics create workspace-events

    आउटपुट में, विषय का पूरा नाम दिखता है. इसे projects/{project}/topics/{topic} के फ़ॉर्मैट में दिखाया जाता है. बाद के चरणों में इस्तेमाल करने के लिए, इस नाम का एक नोट बना लें.

  2. अपने विषय पर मैसेज पब्लिश करने का ऐक्सेस दें: 
     gcloud pubsub topics add-iam-policy-binding workspace-events --member='serviceAccount:meet-api-event-push@system.gserviceaccount.com' --role='roles/pubsub.publisher'

    आपके विषय के लिए अनुमतियां अपडेट करने में कुछ मिनट लग सकते हैं.

  3. इस विषय के लिए Pub/Sub सदस्यता बनाएं: 
    gcloud pubsub subscriptions create workspace-events-sub --topic=TOPIC_NAME

    इन्हें बदलें:

    • TOPIC_NAME: आपके विषय का वह नाम जिसे आपने पिछले चरण में बनाया था.

विषय का नाम नोट कर लें और पक्का करें कि {project} की वैल्यू, आपके ऐप्लिकेशन का Cloud प्रोजेक्ट आईडी हो. बाद में Google Workspace की सदस्यता बनाने के लिए, विषय का नाम इस्तेमाल करें.

सेवा खाता बनाना

Google Cloud कंसोल

  1. Google Cloud Console में, मेन्यू > IAM और एडमिन > सेवा खाते पर जाएं.

    सेवा खातों पर जाएं

  2. सेवा खाता बनाएं पर क्लिक करें.
  3. सेवा खाते की जानकारी भरें. इसके बाद, बनाएं और जारी रखें पर क्लिक करें.
  4. ज़रूरी नहीं: अपने Google Cloud प्रोजेक्ट के संसाधनों का ऐक्सेस देने के लिए, अपने सेवा खाते के लिए भूमिकाएं असाइन करें. ज़्यादा जानकारी के लिए, संसाधनों का ऐक्सेस देना, बदलना, और रद्द करना देखें.
  5. जारी रखें पर क्लिक करें.
  6. ज़रूरी नहीं: उन उपयोगकर्ताओं या ग्रुप के नाम डालें जो इस सेवा खाते से कार्रवाइयां कर सकते हैं और उन्हें मैनेज कर सकते हैं. ज़्यादा जानकारी के लिए, सेवा खाते के डुप्लीकेट को मैनेज करना लेख पढ़ें.
  7. हो गया पर क्लिक करें. सेवा खाते का ईमेल पता नोट कर लें.

gcloud सीएलआई

  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 सीएलआई

  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. Pub/Sub के लिए क्लाइंट लाइब्रेरी इंस्टॉल करने के लिए, pip का इस्तेमाल करें:

    pip install google-cloud-pubsub

  2. इसके बाद, क्लाइंट को इंपोर्ट करने के लिए, main.py में बदलाव करें:

    from google.cloud import pubsub_v1

Google Workspace की सदस्यता बनाएं

Meet इवेंट की सदस्यता लेने का तरीका तय करने के लिए, main.py में यह कोड जोड़ें. यह कोड, मीटिंग स्पेस के सभी इवेंट की सदस्यता लेता है. सदस्यता लेने के बाद, 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 एपीआई का इस्तेमाल करता है. अलग-अलग हैंडलर के तरीके, इनसे जुड़े इवेंट के बारे में जानकारी प्रिंट करते हैं.

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 के उस विषय का नाम जिसे आपने अपने Cloud प्रोजेक्ट में बनाया है.

    • SUBSCRIPTION_ID: आपकी सदस्यता का नाम, जैसे कि workspace-events-sub.

  2. प्रोग्राम चलाएं:

    python3 main.py

अगर आपने पहले कभी प्रोग्राम नहीं चलाया है, तो यह पहली बार अनुमति देने का अनुरोध करता है. Meet REST API को कॉल करने के लिए, ऐप्लिकेशन को ऐक्सेस दें. प्रोग्राम के सही तरीके से चलने के बाद, आपको इससे मिलता-जुलता आउटपुट दिखेगा:

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

कॉन्फ़्रेंस में शामिल हों

ऐप्लिकेशन के लिए इवेंट जनरेट करने के लिए, ऐप्लिकेशन के दिखाए गए यूआरएल का इस्तेमाल करके कॉन्फ़्रेंस में शामिल हों. शामिल होने के बाद, इवेंट ट्रिगर करने के लिए ये कार्रवाइयां आज़माई जा सकती हैं:

  • मीटिंग छोड़ें और फिर से शामिल हों.
  • दूसरों को न्योता दें या अपने फ़ोन से डायल इन करें.
  • रिकॉर्डिंग और ट्रांसक्रिप्ट की सुविधा चालू करें.

इनमें से हर गतिविधि एक इवेंट जनरेट करती है, जो ऐप्लिकेशन को मिलती है और Google Cloud कंसोल में लॉग किया जाता है.

जब आप पूरा कर लें, तो प्रोग्राम को बाधित करने के लिए ctrl-c का इस्तेमाल करें.

ज़रूरी नहीं: समस्या को हल करने के दूसरे तरीके

ऐप्लिकेशन, इवेंट के बारे में बुनियादी जानकारी लॉग करता है. Meet REST API के बारे में जानना जारी रखने के लिए, ऐप्लिकेशन में बदलाव करें, ताकि ये अतिरिक्त कार्रवाइयां की जा सकें.

  • साइन इन किए हुए लोगों के बारे में ज़्यादा जानकारी पाने के लिए, People API का इस्तेमाल करें.
  • रिकॉर्डिंग और ट्रांसक्रिप्ट डाउनलोड करने के लिए, Google Drive API का इस्तेमाल करें.
  • Google Drive से ट्रांसक्रिप्ट डाउनलोड करने के बजाय, Meet REST API में मौजूद स्ट्रक्चर्ड ट्रांसक्रिप्ट के तरीकों का इस्तेमाल करके उसे फिर से पाएं.

ज़रूरी नहीं: स्टोरेज खाली करें

इस ट्यूटोरियल में इस्तेमाल किए गए संसाधनों के लिए, आपके Google Cloud Console खाते पर शुल्क न लगे, इसके लिए हमारा सुझाव है कि आप बनाए गए सभी संसाधन और प्रोजेक्ट ठीक कर लें.

सदस्यता मिटाने के लिए:

कंसोल

  1. Google Cloud Console में, मेन्यू > Pub/Sub > सदस्यताएं पर जाएं

    'सदस्यताएं' पर जाएं

  2. सदस्यता चुनें और ज़्यादा कार्रवाइयां पर क्लिक करें.

  3. हटाएं पर क्लिक करें. आपको सदस्यता मिटाएं विंडो दिखेगी.

  4. हटाएं पर क्लिक करें.

gcloud सीएलआई

  1. सदस्यता मिटाने के लिए:

    gcloud pubsub subscriptions delete SUBSCRIPTION_NAME

विषय को मिटाने के लिए:

कंसोल

  1. Google Cloud Console में, मेन्यू > Pub/Sub > विषय पर जाएं

    Topics पर जाएं

  2. विषय चुनें और ज़्यादा कार्रवाइयां पर क्लिक करें.

  3. हटाएं पर क्लिक करें. आपको विषय मिटाएं विंडो दिखेगी.

  4. delete डालें. इसके बाद, मिटाएं पर क्लिक करें.

gcloud सीएलआई

  1. विषय मिटाएं:

    gcloud pubsub topics delete TOPIC_NAME

प्रोजेक्ट मिटाने के लिए:

कंसोल

  1. Google Cloud Console में, संसाधनों को मैनेज करें पेज पर जाएं. मेन्यू > IAM और एडमिन > संसाधन मैनेज करें पर क्लिक करें.

    संसाधन मैनेजर पर जाएं

  2. प्रोजेक्ट की सूची में, वह प्रोजेक्ट चुनें जिसे मिटाना है. इसके बाद, मिटाएं पर क्लिक करें.
  3. डायलॉग बॉक्स में, प्रोजेक्ट आईडी टाइप करें. इसके बाद, प्रोजेक्ट मिटाने के लिए, शट डाउन करें पर क्लिक करें.

gcloud सीएलआई

  1. किसी प्रोजेक्ट को मिटाने के लिए, gcloud projects delete कमांड का इस्तेमाल करें:

    gcloud projects delete PROJECT_ID