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

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

किसी मीटिंग स्पेस की सदस्यता लेने के बजाय, Meet के किसी उपयोगकर्ता की सदस्यता ली जा सकती है. इससे, उस उपयोगकर्ता के मालिकाना हक वाले या मैनेज किए जा रहे किसी भी मीटिंग स्पेस के इवेंट की सूचनाएं मिलती रहेंगी. ज़्यादा जानकारी के लिए, Google Workspace Events API के दस्तावेज़ में, Google Meet इवेंट की सदस्यता लें देखें.

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

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

• Google Workspace खाता, जिसमें Google Meet का ऐक्सेस हो.
• Google Cloud प्रोजेक्ट बनाने का ऐक्सेस.
• Python 3 इंस्टॉल हो.
• gcloud सीएलआई इंस्टॉल हो गया हो.

अपना एनवायरमेंट तैयार करना

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

वर्किंग डायरेक्ट्री और Python वर्चुअल एनवायरमेंट बनाना

नया वर्चुअल एनवायरमेंट बनाने और चालू करने के लिए, अपने टर्मिनल में ये कमांड चलाएं.

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

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

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

Google Cloud प्रोजेक्ट बनाना

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

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

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

OAuth की सहमति वाली स्क्रीन को कॉन्फ़िगर करना और दायरे चुनना

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

1. Google Cloud Console में, मेन्यू menu > एपीआई और सेवाएं > 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 में, मेन्यू menu > एपीआई और सेवाएं > क्रेडेंशियल पर जाएं.

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

2. क्रेडेंशियल बनाएं > OAuth क्लाइंट आईडी पर क्लिक करें.
3. ऐप्लिकेशन का टाइप > डेस्कटॉप ऐप्लिकेशन पर क्लिक करें.
4. नाम फ़ील्ड में, क्रेडेंशियल के लिए कोई नाम टाइप करें. यह नाम सिर्फ़ Google Cloud Console में दिखता है.
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 को चालू करने और उसे कॉल करने का समय आ गया है.

एपीआई चालू करना

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

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 विषय बनाने और उसकी सदस्यता लेने के लिए:

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

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

सेवा खाते का इस्तेमाल करना

सेवा खाता बनाने के बाद, खुद को सेवा खाते के तौर पर काम करने का ऐक्सेस दें.

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 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 टॉपिक का नाम जिसे आपने अपने 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 खाते से शुल्क न लिया जाए. इसके लिए, बनाए गए सभी संसाधनों और प्रोजेक्ट को मिटा दें.

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

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

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

मिलते-जुलते विषय

• Meet पर होने वाले किस तरह के इवेंट की सदस्यता ली जा सकती है, इस बारे में जानें.
• Google Meet REST API क्या-क्या कर सकता है, इस बारे में ज़्यादा जानें. साथ ही, रेफ़रंस दस्तावेज़ देखें.
• Google Workspace Events API का इस्तेमाल करके, Meet के मीटिंग स्पेस या उपयोगकर्ताओं को Google Workspace की सदस्यता लें.
• पुष्टि करने के बारे में ज़्यादा जानने के लिए, OAuth की सहमति वाली स्क्रीन को कॉन्फ़िगर करना और दायरे चुनना लेख पढ़ें.