Osserva gli eventi delle riunioni con Python e l'API REST di Google Meet

Questo tutorial mostra come utilizzare l'API REST Google Meet insieme alla API Google Workspace Events e Google Cloud Pub/Sub per osservare e reagire agli eventi in uno spazio per riunioni di Meet. L'applicazione di esempio registra quando l'inizio e la fine delle conferenze, quando i partecipanti entrano o escono e quando gli artefatti della riunione generati sono disponibili.

Invece di iscriverti a uno spazio specifico per le riunioni, puoi iscriverti a a un utente di Meet per ricevere eventi per qualsiasi spazio per riunioni in cui che l'utente possiede o organizza. Per maggiori dettagli, vedi Iscriversi agli eventi di Google Meet nella documentazione dell'API Google Workspace Events.

Prerequisiti

Se hai bisogno che uno di questi prerequisiti venga attivato per la tua organizzazione, chiedi all'amministratore di Google Workspace di attivarlo:

• Un account Google Workspace con l'accesso a Google Meet.
• Accesso per creare un progetto Google Cloud.
• Python 3 installato.
• gcloud CLI installato.

prepara l'ambiente

Questa sezione mostra come creare e configurare l'ambiente locale e progetto Google Cloud per questo tutorial.

Crea una directory di lavoro e un ambiente virtuale Python

Per creare e attivare un nuovo virtuale ambiente, esegui il comando seguente comandi nel terminale.

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

Crea un progetto Google Cloud

Abilita la fatturazione per il progetto Google Cloud

Configurare l'autenticazione e l'autorizzazione

L'autenticazione e l'autorizzazione consentono all'app di accedere alle risorse dell'API REST di Meet. Per chiamare l'API REST Meet è necessaria l'autorizzazione dell'utente. Questa sezione spiega come configurare le credenziali utente e la richiesta autorizzazione.

Configura la schermata per il consenso OAuth e scegli gli ambiti

I passaggi seguenti suggeriscono informazioni sui segnaposto da configurare la schermata per il consenso OAuth per la tua app. Prima di pubblicare l'app esternamente, aggiorna queste informazioni.

1. Nella console Google Cloud, vai al Menu menu > API e Servizi > Schermata consenso OAuth.

   Vai alla schermata per il consenso OAuth

2. In Tipo di utente, seleziona Interno e poi fai clic su Crea.
3. In Nome app, inserisci Meet REST API Tutorial.
4. Compila il modulo di registrazione dell'app, quindi fai clic su Salva e continua.
5. Fai clic su Aggiungi o rimuovi ambiti. Viene visualizzato un riquadro con un elenco di ambiti per ogni API abilitata nel tuo progetto Google Cloud.
6. In Aggiungi ambiti manualmente, incolla i seguenti ambiti:
   • https://www.googleapis.com/auth/meetings.space.created
7. Fai clic su Aggiungi alla tabella.
8. Fai clic su Aggiorna.
9. Dopo aver selezionato gli ambiti richiesti dall'app, fai clic su Salva e continua.
10. Se hai selezionato Esterni come tipo di utente, aggiungi utenti di test:
    1. In Utenti di test, fai clic su Aggiungi utenti.
    2. Inserisci il tuo indirizzo email e gli eventuali altri utenti di test autorizzati, quindi fai clic su Salva e continua.
11. Rivedi il riepilogo della registrazione dell'app. Per apportare modifiche, fai clic su Modifica. Se la registrazione dell'app sembra corretta, fai clic su Torna alla dashboard.

Crea un ID client

L'ID client funge da credenziali per l'applicazione durante la procedura OAuth 2.0 dei flussi. Poiché l'app viene eseguita localmente, crea un ID client desktop.

1. Nella console Google Cloud, vai a Menu menu > API e Servizi > Credenziali.

   Vai a credenziali

2. Fai clic su Crea credenziali > ID client OAuth.
3. Fai clic su Tipo di applicazione > App desktop.
4. Nel campo Nome, digita un nome per la credenziale. Questo nome viene visualizzato solo nella console Google Cloud.
5. Fai clic su Crea. Viene visualizzata la schermata di creazione del client OAuth, che mostra il nuovo ID client e il nuovo client secret.
6. Fai clic su OK. Le credenziali appena create vengono visualizzate nella sezione ID client OAuth 2.0.

Installa le librerie di autenticazione Google

Installa le librerie di autenticazione di Google:

pip install google-auth google-auth-oauthlib

Esegui autorizzazione

L'API REST Meet richiede le credenziali utente sotto forma di OAuth 2.0 token di accesso. In questa sezione, implementerai il flusso OAuth 2.0 per richiedere un di accesso e un token di aggiornamento per l'utente.

1. Nella directory di lavoro, crea il file main.py e aggiungi quanto segue contenuti:

   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. Per eseguire il codice, sia l'ID client che il secret creati in precedenza obbligatorio. Copia il file del secret client scaricato nella directory di lavoro del progetto e rinominalo in client_secret.json.

3. Se vuoi testare il funzionamento dell'autorizzazione, esegui il seguente comando. L'app richiede l'autorizzazione e crea un file token.json nel della directory di lavoro del progetto dopo l'approvazione della richiesta.

   python3 main.py

Aggiungi l'API REST di Meet

Ora che il codice di autorizzazione è completo, è il momento di abilitare e chiamare il metodo l'API REST Meet.

Abilita le API

Questa sezione è incentrata sull'API REST Meet, ma in questo tutorial viene utilizzato anche Google Cloud Pub/Sub e l'API Google Workspace Events.

Installa la libreria client dell'API REST di Meet

Segui questi passaggi per installare la libreria client dell'API REST Meet:

1. Esegui il comando:

   pip install google-apps-meet

2. Modifica il file main.py per importare il client:

   from google.apps import meet_v2 as meet
   

Crea uno spazio

Ora che l'API REST di Meet è disponibile, definisci una funzione per creare uno spazio di riunione a cui è possibile iscriversi.

Modifica main.py e aggiungi:

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

Iscriversi agli eventi

Per ricevere eventi relativi a uno spazio di riunione, crea una sottoscrizione utilizzando l'API Google Workspace Events. Devi inoltre creare e sottoscrivere un l'argomento Google Cloud Pub/Sub, che funge da endpoint di notifica che l'app riceve gli eventi.

Configurare Google Cloud Pub/Sub

Per creare e sottoscrivere un argomento Pub/Sub:

Prendi nota del nome dell'argomento e assicurati che il valore per {project} sia il ID progetto Cloud per la tua app. Utilizzerai il nome dell'argomento per creare l'abbonamento a Google Workspace in un secondo momento.

Crea un account di servizio

Utilizza l'account di servizio

Dopo aver creato l'account di servizio, concediti l'accesso per impersonare il l'account di servizio.

installa la libreria client di Pub/Sub

1. Utilizza pip per installare la libreria client per Pub/Sub:

   pip install google-cloud-pubsub

2. Quindi, modifica main.py per importare il client:

   from google.cloud import pubsub_v1
   

Crea l'abbonamento a Google Workspace

Aggiungi il seguente codice a main.py per definire un metodo per l'iscrizione a Eventi di Meet. Questo codice consente di effettuare l'iscrizione a tutti gli eventi di una riunione spazio. Quando è sottoscritta, gli eventi vengono pubblicati nell'argomento 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

Quindi, aggiungi il codice corrispondente per eseguire il pull e l'elaborazione degli eventi.

Ascolta e gestisci gli eventi

Continua a modificare main.py e aggiungi il seguente codice di esempio. Questo codice implementa il lato ricevente e utilizza l'API Google Cloud Pub/Sub per eseguire il pull disponibili non appena diventano disponibili. I vari metodi di gestione stampano le informazioni sugli eventi corrispondenti.

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")

Finalizza il codice

Aggiungi il seguente codice a main.py per chiamare i metodi per creare lo spazio: abbonarsi a eventi e ascoltare. Aggiorna TOPIC_NAME e SUBSCRIPTION_NAME costante con il tuo argomento e i nomi degli abbonamenti che hai usato è stato creato.

1. Aggiungi il codice a 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)
   

   Sostituisci quanto segue:

   • PROJECT_ID: l'ID progetto Cloud univoco per la tua app, ad esempio my-sample-project-191923.

   • TOPIC_ID: il nome dell'argomento Pub/Sub che hai creato nel tuo progetto Cloud.

   • SUBSCRIPTION_ID: il nome del tuo abbonamento, ad esempio workspace-events-sub.

2. Esegui il programma:

   python3 main.py

Se non hai mai eseguito il programma, ti verrà richiesta l'autorizzazione. per la prima volta. Concedi l'accesso all'applicazione per chiamare l'API REST Meet. Dopo l'esecuzione del programma, dovresti visualizzare un output simile al seguente:

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

Partecipa alla conferenza

Per generare eventi per l'applicazione, partecipa alla conferenza utilizzando l'URL visualizzato dall'applicazione. Dopo aver eseguito l'accesso, puoi provare queste azioni per attivare gli eventi:

• Abbandona e rientra nella riunione.
• Invita altre persone o ti connetti via telefono.
• Abilita registrazioni e trascrizioni.

Ognuna di queste attività genera un evento che l'applicazione riceve e i log alla console Google Cloud.

Usa ctrl-c per interrompere il programma al termine.

Facoltativo: passaggi aggiuntivi da provare

L'app registra i dettagli di base degli eventi. Per continuare a esplorare l'API REST di Meet, prova a modificare l'applicazione per eseguire queste altre azioni.

• Utilizza l'API People per recuperare ulteriori informazioni su partecipanti che hanno eseguito l'accesso.
• Utilizza l'API Google Drive per scaricare le registrazioni e trascrizioni.
• Anziché scaricare le trascrizioni da Google Drive, recuperale utilizzando la trascrizione strutturata nell'API REST Meet.

(Facoltativo) Eseguire la pulizia

Per evitare che al tuo account della console Google Cloud vengano addebitati costi relativi alle risorse utilizzate in questo tutorial, ti consigliamo di ripulire le risorse e i progetti creati.

Per eliminare l'abbonamento:

Per eliminare l'argomento:

Per eliminare il progetto:

Argomenti correlati

• Scopri di più sulla tipi di eventi di Meet a cui puoi iscriverti.
• Scopri di più su cosa può fare l'API REST Google Meet e consulta la documentazione di riferimento.
• Creare un abbonamento a Google Workspace agli spazi per riunioni di Meet o agli utenti utilizzando API Google Workspace Events.
• Per scoprire di più sull'autenticazione, consulta Configurare la schermata per il consenso OAuth e scegli gli ambiti.