تمت ترجمة هذه الصفحة بواسطة Cloud Translation API‏.

تتبُّع أحداث الاجتماعات باستخدام Python وGoogle Meet REST API

يوضّح هذا الدليل التعليمي كيفية استخدام Google Meet REST API مع Google Workspace Events API وGoogle Cloud Pub/Sub لمراقبة الأحداث والتفاعل معها في مساحة اجتماع Meet. يسجِّل نموذج التطبيق وقت بدء المؤتمرات وانتهائها، ووقت انضمام المشاركين أو مغادرتهم، ووقت توفُّر أي مواد عرض تم إنشاؤها للاجتماع.

بدلاً من الاشتراك في مساحة اجتماعات معيّنة، يمكنك الاشتراك في مستخدم Meet لتلقّي أحداث أي مساحة اجتماعات يملكها المستخدم أو ينظّمها. لمعرفة التفاصيل، يُرجى الاطّلاع على الاشتراك في أحداث Google Meet في مستندات Google Workspace Events API.

المتطلبات الأساسية

إذا كنت بحاجة إلى تفعيل أيّ من المتطلبات الأساسية هذه لمؤسستك، يُرجى طلب تفعيلها من مشرف Google Workspace:

حساب على Google Workspace يتيح الوصول إلى Google Meet
إذن الوصول لإنشاء مشروع على Google Cloud
تثبيت Python 3
تم تثبيت gcloud CLI.

إعداد البيئة

يوضّح هذا القسم كيفية إنشاء وضبط البيئة المحلية وproject 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 Console

في Google Cloud Console، انتقِل إلى القائمة > المشرف وإدارة الهوية وإمكانية الوصول > إنشاء مشروع.
الانتقال إلى "إنشاء مشروع"
في حقل اسم المشروع، أدخِل اسمًا وصفيًا لمشروعك.
اختياري: لتعديل رقم تعريف المشروع، انقر على تعديل. لا يمكن تغيير معرّف المشروع بعد إنشائه، لذا اختَر معرّفًا يلبي احتياجاتك طوال مدّة المشروع.
في حقل الموقع الجغرافي، انقر على تصفّح لعرض المواقع الجغرافية المحتملة لمشروعك. بعد ذلك، انقر على اختيار.
انقر على إنشاء. تنتقل وحدة تحكّم Google Cloud إلى صفحة "لوحة البيانات" ويتم إنشاء مشروعك في غضون بضع دقائق.

gcloud CLI

في إحدى بيئات التطوير التالية، يمكنك الوصول إلى Google Cloud CLI (gcloud):

Cloud Shell: لاستخدام وحدة طرفية على الإنترنت تم إعداد واجهة سطر أوامر gcloud CLI عليها، فعِّل Cloud Shell.
تفعيل Cloud Shell
Shell المحلي: لاستخدام بيئة تطوير محلية، ثبِّت و افتح أداة gcloud CLI.
لإنشاء مشروع على Cloud، استخدِم الأمر gcloud projects create:
```
gcloud projects create PROJECT_ID
```
استبدِل PROJECT_ID بتحديد رقم تعريف المشروع الذي تريد إنشاؤه.

تفعيل الفوترة لمشروع Google Cloud

Google Cloud Console

في Google Cloud Console، انتقِل إلى الفوترة. انقر على القائمة > الفوترة > مشاريعي.
الانتقال إلى "الفوترة لمشاريعي"
في اختيار مؤسسة، اختَر المؤسسة المرتبطة بمشروعك على Google Cloud.
في صف المشروع، افتح قائمة الإجراءات ()، وانقر على تغيير الفوترة، ثم اختَر حساب "الفوترة في السحابة الإلكترونية".
انقر على ضبط الحساب.

gcloud CLI

لعرض حسابات الفوترة المتاحة، يمكنك تنفيذ ما يلي:
```
gcloud billing accounts list
```
ربط حساب فوترة بمشروع على Google Cloud:
```
gcloud billing projects link PROJECT_ID --billing-account=BILLING_ACCOUNT_ID
```
غيِّر القيم في السلسلة على الشكل التالي:
- PROJECT_ID هو رقم تعريف المشروع لمشروع Cloud الذي تريد تفعيل الفوترة له.
- BILLING_ACCOUNT_ID هو معرّف حساب الفوترة المطلوب ربطه بمشروع Google Cloud.

إعداد المصادقة والتفويض

تتيح المصادقة والتفويض للتطبيق الوصول إلى موارد Meet REST API. يجب الحصول على تفويض المستخدم للاتصال بواجهة برمجة التطبيقات Meet REST API. يوضّح لك هذا القسم كيفية ضبط بيانات اعتماد المستخدمين وطلب التفويض.

ضبط شاشة طلب الموافقة المتعلّقة ببروتوكول OAuth واختيار النطاقات

تقترح الخطوات التالية معلومات نائبة لضبط شاشة موافقة OAuth لتطبيقك. عليك تعديل هذه المعلومات قبل نشر التطبيق خارجيًا.

في وحدة تحكّم Google Cloud، انتقِل إلى رمز القائمة > APIs & Services (واجهات برمجة التطبيقات والخدمات) > OAuth consent screen (شاشة موافقة OAuth).
الانتقال إلى شاشة طلب الموافقة المتعلّقة ببروتوكول OAuth
ضمن نوع المستخدم، اختَر داخلي، ثم انقر على إنشاء.
إذا لم تتمكّن من إنشاء تطبيق داخلي، اختَر خارجي.
في اسم التطبيق، أدخِل Meet REST API Tutorial.
املأ نموذج تسجيل التطبيق، ثم انقر على حفظ ومتابعة.
انقر على إضافة نطاقات أو إزالتها. تظهر لوحة تتضمّن قائمة النطاقات لكل واجهة برمجة تطبيقات فعّلتها في مشروعك على Google Cloud.
ضمن إضافة النطاقات يدويًا، الصِق النطاقات التالية:
- https://www.googleapis.com/auth/meetings.space.created
انقر على الإضافة إلى الجدول.
انقر على تعديل.
بعد اختيار النطاقات المطلوبة لتطبيقك، انقر على حفظ ومتابعة.
إذا اخترت خارجي لنوع المستخدم، أضِف مستخدمين تجريبيين:
1. ضمن مستخدمو الاختبار، انقر على إضافة مستخدمين.
2. أدخِل عنوان بريدك الإلكتروني وأي مستخدمين آخرين معتمَدين للاختبار، ثم انقر على حفظ ومتابعة.
راجِع ملخّص تسجيل تطبيقك. لإجراء تغييرات، انقر على تعديل. إذا كان تسجيل التطبيق يبدو جيدًا، انقر على الرجوع إلى لوحة البيانات.

إنشاء معرّف عميل

يعمل معرّف العميل بمثابة بيانات اعتماد لتطبيقك أثناء عمليات تسجيل OAuth 2.0. بما أنّ التطبيق يتم تشغيله على الجهاز، أنشئ معرِّف عميل لأجهزة الكمبيوتر المكتبي.

في وحدة تحكّم Google Cloud، انتقِل إلى رمز القائمة > واجهات برمجة التطبيقات والخدمات > بيانات الاعتماد.
الانتقال إلى "بيانات الاعتماد"
انقر على إنشاء بيانات اعتماد > معرِّف عميل OAuth.
انقر على نوع التطبيق > تطبيق كمبيوتر مكتبي.
في حقل الاسم، اكتب اسمًا لبيانات الاعتماد. ولا يظهر هذا الاسم إلا في "وحدة تحكّم Google Cloud".
انقر على إنشاء. تظهر شاشة "تم إنشاء عميل OAuth"، والتي تعرض معرّف العميل الجديد وسرّه.
انقر على موافق. تظهر بيانات الاعتماد التي تم إنشاؤها حديثًا ضمن معرِّفات عملاء OAuth 2.0.

تثبيت مكتبات مصادقة Google

ثبِّت مكتبات مصادقة Google:

pip install google-auth google-auth-oauthlib

تنفيذ التفويض

تتطلّب Meet REST API بيانات اعتماد المستخدم في شكل رمز مميز لمنح إذن الوصول باستخدام بروتوكول OAuth 2.0. في هذا القسم، يمكنك تنفيذ مسار OAuth 2.0 لطلب رمز ميز وصول ورمز ميز إعادة تحميل للمستخدم.

في دليل العمل، أنشئ الملف 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()

لتشغيل الرمز، يجب استخدام كلّ من معرّف العميل والسرية اللذَين تم إنشاؤهما في وقت سابق. انسخ ملف سر العميل الذي تم تنزيله إلى دليل العمل في المشروع وأعِد تسميته باسم client_secret.json.
إذا أردت اختبار طريقة عمل التفويض، شغِّل الأمر التالي. يطلب التطبيق الحصول على إذن وينشئ ملف token.json في directory directory project بعد الموافقة على الطلب.
```
python3 main.py
```

إضافة واجهة برمجة تطبيقات Meet REST

بعد اكتمال رمز التفويض، حان وقت تفعيل واجهة برمجة التطبيقات Meet REST API والاتصال بها.

تفعيل واجهات برمجة التطبيقات

على الرغم من أنّ هذا القسم يركّز على Meet REST API، تستخدم هذه المقالة التعليمية أيضًا Google Cloud Pub/Sub وGoogle Workspace Events API.

Google Cloud Console

في Google Cloud Console، فعِّل Google Meet REST API و Google Workspace Events API وGoogle Cloud Pub/Sub.

تفعيل واجهات برمجة التطبيقات
تأكَّد من أنّك تفعّل واجهات برمجة التطبيقات في مشروع Cloud الصحيح، ثم انقر على التالي.
تأكَّد من تفعيل واجهات برمجة التطبيقات الصحيحة، ثم انقر على تفعيل.

gcloud CLI

إذا لزم الأمر، اضبط مشروع Cloud الحالي على المشروع الذي أنشأته باستخدام الأمر gcloud config set project:
```
gcloud config set project PROJECT_ID
```
استبدِل PROJECT_ID بـ رقم تعريف المشروع لمشروع Cloud الذي أنشأته.
فعِّل 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:

شغِّل الأمر:
```
pip install google-apps-meet
```
عدِّل ملف 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 Console

في وحدة تحكّم Google Cloud، انتقِل إلى رمز القائمة > Pub/Sub.
الانتقال إلى Pub/Sub

تأكَّد من اختيار مشروع Cloud لتطبيقك.
انقر على add_box إنشاء موضوع واتّبِع الخطوات التالية:
1. أدخِل workspace-events كاسم الموضوع.
2. اترك الخيار إضافة اشتراك تلقائي محدّدًا.
3. انقر على إنشاء. يتم تنسيق اسم الموضوع الكامل على النحو التالي: projects/{project}/topics/{topic}. دوِّن هذا الاسم لاستخدامه في الخطوات اللاحقة.
امنح إذن الوصول لنشر رسائل Pub/Sub في موضوعك:
1. في اللوحة الجانبية، افتح علامة التبويب الأذونات.
2. انقر على إضافة مشرف.
3. في العناصر الرئيسية الجديدة، أدخِل meet-api-event-push@system.gserviceaccount.com.
4. في إسناد الأدوار، اختَر Pub/Sub Publisher.
5. انقر على حفظ.
قد يستغرق تعديل الأذونات لموضوعك بضع دقائق.

gcloud CLI

في مشروعك على Cloud، أنشئ موضوعًا من خلال تنفيذ ما يلي:
```
gcloud pubsub topics create workspace-events
```
تعرِض النتيجة اسم الموضوع الكامل بالتنسيق التالي: projects/{project}/topics/{topic}. دوِّن هذا الاسم لاستخدامه في الخطوات اللاحقة.
يمكنك منح إذن الوصول لنشر الرسائل في موضوعك باتّباع الخطوات التالية:
```
 gcloud pubsub topics add-iam-policy-binding workspace-events --member='serviceAccount:meet-api-event-push@system.gserviceaccount.com' --role='roles/pubsub.publisher'
```
قد يستغرق تعديل الأذونات لموضوعك بضع دقائق.
أنشئ اشتراكًا في Pub/Sub للموضوع:
```
gcloud pubsub subscriptions create workspace-events-sub --topic=TOPIC_NAME
```
غيِّر القيم في السلسلة على الشكل التالي:
- TOPIC_NAME: اسم الموضوع الذي أنشأته في الخطوة السابقة.

دوِّن اسم الموضوع وتأكَّد من أنّ القيمة الخاصة بالعنصر {project} هي معرّف مشروع Cloud لتطبيقك. ستستخدم اسم الموضوع لإنشاء اشتراك Google Workspace لاحقًا.

إنشاء حساب خدمة

Google Cloud Console

في Google Cloud Console، انتقِل إلى رمز القائمة > إدارة الهوية وإمكانية الوصول والمشرف > حسابات الخدمة.
الانتقال إلى "حسابات الخدمة"
انقر على إنشاء حساب خدمة.
املأ تفاصيل حساب الخدمة، ثم انقر على إنشاء ومتابعة.
ملاحظة: تنشئ Google تلقائيًا معرّفًا فريدًا لحساب الخدمة. إذا أردت تغيير المعرّف، عدِّله في حقل معرّف حساب الخدمة.
اختياري: يمكنك إسناد أدوار إلى حساب الخدمة لمنح إذن الوصول إلى موارد مشروعك على Google Cloud. لمزيد من التفاصيل، يُرجى الاطّلاع على منح إذن الوصول إلى الموارد وتغييره وإبطاله.
انقر على متابعة.
اختياري: أدخِل المستخدمين أو المجموعات التي يمكنها إدارة الإجراءات وتنفيذها باستخدام حساب الخدمة هذا. لمزيد من التفاصيل، يُرجى الاطّلاع على مقالة إدارة انتحال هوية حساب الخدمة.
انقر على تم. دوِّن عنوان البريد الإلكتروني لحساب الخدمة.

gcloud CLI

أنشئ حساب الخدمة باتّباع الخطوات التالية:

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

اختياري: يمكنك إسناد أدوار إلى حساب الخدمة لمنح إذن الوصول إلى موارد مشروعك على Google Cloud. لمزيد من التفاصيل، يُرجى الاطّلاع على منح إذن الوصول إلى الموارد وتغييره وإبطاله.

استخدام حساب الخدمة

بعد إنشاء حساب الخدمة، امنح نفسك إذن الوصول إلى التنكر في صفت حساب الخدمة.

Google Cloud Console

في عمود الإجراءات لحساب الخدمة الذي تم إنشاؤه حديثًا، انقر على > إدارة الأذونات.
انقر على إضافة مفتاح > منح الإذن بالوصول.
أدخِل عنوان بريدك الإلكتروني ضمن إضافة عناصر أساسية.
اختَر حسابات الخدمة > صانع رمز مفتاح حساب الخدمة كدور.
انقر على حفظ.
ارجع إلى وحدة التحكّم وسجِّل الدخول باستخدام gcloud لضبط بيانات الاعتماد التلقائية للتطبيق على حساب الخدمة. عند طلب التفويض، سجِّل الدخول باستخدام الحساب نفسه المستخدَم في الخطوات السابقة.
```
gcloud auth application-default login --impersonate-service-account=SERVICE_ACCOUNT_EMAIL
```

gcloud CLI

لإضافة الإذن، نفِّذ 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"
```
سجِّل الدخول لضبط بيانات الاعتماد التلقائية للتطبيق على حساب الخدمة. عند طلب التفويض، سجِّل الدخول باستخدام الحساب نفسه المستخدَم في الخطوات السابقة.
```
gcloud auth application-default login --impersonate-service-account=SERVICE_ACCOUNT_EMAIL
```

تثبيت مكتبة برامج Pub/Sub

استخدِم pip لتثبيت مكتبة العميل لخدمة Pub/Sub:
```
pip install google-cloud-pubsub
```
بعد ذلك، عدِّل 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 باستخدام اسم الموضوع وأسماء الاشتراكات التي سبق أن أنشأتها.

أضِف الرمز إلى 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
شغِّل البرنامج باتّباع الخطوات التالية:
```
python3 main.py
```

إذا لم يسبق لك تشغيل البرنامج، سيُطلب منك منح التفويض في المرة الأولى. امنح التطبيق إذن الوصول إلى واجهة برمجة تطبيقات Meet REST. بعد تشغيل البرنامج بنجاح، من المفترض أن يظهر لك ناتج مشابه لما يلي:

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

الانضمام إلى المؤتمر

لإنشاء أحداث للتطبيق، انضم إلى المؤتمر باستخدام عنوان URL الذي يعرضه التطبيق. بعد الانضمام، يمكنك تجربة الإجراءات التالية لبدء الأحداث:

يُرجى مغادرة الاجتماع والانضمام إليه مجددًا.
يمكنك دعوة مستخدمين آخرين أو الاتصال باستخدام هاتفك.
فعِّل التسجيلات والنصوص.

يُنشئ كلّ نشاط من هذه الأنشطة حدثًا يتلقّاه التطبيق ويُسجّله في وحدة تحكّم Google Cloud.

استخدِم ctrl-c لإيقاف البرنامج عند الانتهاء.

خطوات إضافية يمكنك تجربتها (اختيارية)

يسجِّل التطبيق تفاصيل أساسية عن الأحداث. لمواصلة استكشاف واجهة برمجة التطبيقات Meet REST API، جرِّب تعديل التطبيق لتنفيذ هذه الخطوات الإضافية.

استخدِم People API لاسترداد معلومات إضافية عن المشاركين الذين سجّلوا الدخول.
استخدِم Google Drive API لتنزيل التسجيلات والنصوص.
بدلاً من تنزيل النصوص من Google Drive، يمكنك استردادها باستخدام طرق النصوص المنظَّمة في Meet REST API.

اختياري: تنظيف

لتجنُّب تحمُّل رسوم على حسابك على Google Cloud Console مقابل الموارد المستخدَمة في هذا الدليل التعليمي، ننصحك بتنظيف أي موارد ومشاريع تم إنشاؤها.

لحذف الاشتراك:

وحدة التحكّم

في وحدة تحكّم Google Cloud، انتقِل إلى القائمة > Pub/Sub > الاشتراكات.

الانتقال إلى "الاشتراكات"
اختَر الاشتراك وانقر على المزيد من الإجراءات.
انقر على حذف. تظهر نافذة حذف الاشتراك.
انقر على حذف.

gcloud CLI

لحذف الاشتراك:

gcloud pubsub subscriptions delete SUBSCRIPTION_NAME

لحذف الموضوع، اتّبِع الخطوات التالية:

وحدة التحكّم

في وحدة تحكّم Google Cloud، انتقِل إلى القائمة > Pub/Sub > Topics.

الانتقال إلى "المواضيع"
اختَر الموضوع وانقر على مزيد من الإجراءات.
انقر على حذف. تظهر نافذة حذف الموضوع.
أدخِل delete ثم انقر على حذف.

gcloud CLI

لحذف الموضوع، اتّبِع الخطوات التالية:
```
gcloud pubsub topics delete TOPIC_NAME
```

لحذف المشروع:

وحدة التحكّم

تحذير: يؤدي حذف مشروع إلى النتائج التالية:

يتم حذف كل المحتوى في المشروع. إذا استخدمت مشروعًا حاليًا في هذا الدليل التعليمي، سيؤدي حذفه إلى حذف أي عمل آخر أجريته في المشروع.
فقدان أرقام تعريف المشاريع المخصّصة عند إنشاء هذا المشروع، ربما أنشأت معرّف مشروع مخصّصًا تريد استخدامه في المستقبل. للحفاظ على عناوين URL التي تستخدِم رقم تعريف المشروع، مثل عنوان URL على appspot.com، يمكنك حذف الموارد المحدّدة داخل المشروع بدلاً من حذف المشروع بأكمله.

إذا كنت تخطّط لاستكشاف عدة برامج تعليمية وبرامج سريعة البدء، يمكن أن يساعدك إعادة استخدام المشاريع في تجنُّب تجاوز حدود الحصة المخصّصة للمشاريع.

في وحدة تحكّم Google Cloud، انتقِل إلى صفحة إدارة الموارد. انقر على القائمة > إدارة الهوية وإمكانية الوصول والمشرف > إدارة الموارد.
انتقِل إلى "مدير الموارد"
في قائمة المشاريع، اختَر المشروع الذي تريد حذفه، ثم انقر على حذف .
في مربّع الحوار، اكتب رقم تعريف المشروع، ثم انقر على إيقاف لحذف المشروع.

gcloud CLI

لحذف مشروع، استخدِم الأمر gcloud projects delete:
```
gcloud projects delete PROJECT_ID
```

تعرَّف على أنواع أحداث Meet التي يمكنك الاشتراك فيها.
اطّلِع على مزيد من المعلومات حول الإجراءات التي يمكن أن تتّخذها واجهة برمجة التطبيقات Google Meet REST API و راجِع المستندات المرجعية.
أنشئ اشتراكًا في Google Workspace لمساحات اجتماعات Meet أو المستخدمين باستخدام Google Workspace Events API.
لمزيد من المعلومات عن المصادقة، اطّلِع على مقالة ضبط شاشة موافقة بروتوكول OAuth واختيار النطاقات.

تتبُّع أحداث الاجتماعات باستخدام Python وGoogle Meet REST API

المتطلبات الأساسية

إعداد البيئة

إنشاء دليل عمل وبيئة Python افتراضية

‫Linux/macOS

نظام التشغيل Windows (موجِّه الأوامر)

نظام التشغيل Windows (PowerShell)

إنشاء مشروع على Google Cloud

Google Cloud Console

gcloud CLI

تفعيل الفوترة لمشروع Google Cloud

Google Cloud Console

gcloud CLI

إعداد المصادقة والتفويض

ضبط شاشة طلب الموافقة المتعلّقة ببروتوكول OAuth واختيار النطاقات

إنشاء معرّف عميل

تثبيت مكتبات مصادقة Google

تنفيذ التفويض

إضافة واجهة برمجة تطبيقات Meet REST

تفعيل واجهات برمجة التطبيقات

Google Cloud Console

gcloud CLI

تثبيت مكتبة عملاء Meet REST API

إنشاء مساحة

الاشتراك في الأحداث

ضبط إعدادات Google Cloud Pub/Sub

Google Cloud Console

gcloud CLI

إنشاء حساب خدمة

Google Cloud Console

gcloud CLI

استخدام حساب الخدمة

Google Cloud Console

gcloud CLI

تثبيت مكتبة برامج Pub/Sub

إنشاء اشتراك Google Workspace

الاستماع إلى الأحداث ومعالجتها

إكمال الرمز

الانضمام إلى المؤتمر

خطوات إضافية يمكنك تجربتها (اختيارية)

اختياري: تنظيف

وحدة التحكّم

gcloud CLI

وحدة التحكّم

gcloud CLI

وحدة التحكّم

gcloud CLI

مواضيع ذات صلة