حذف اشتراك Google Workspace

توضّح هذه الصفحة كيفية حذف اشتراك Google Workspace باستخدام الطريقة subscriptions.delete().

عند حذف اشتراك، لن يتلقّى تطبيقك أي أحداث بعد ذلك. في حال انتهاء صلاحية الاشتراك، تحذفه Google Workspace Events API تلقائيًا.

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

برمجة تطبيقات

  • مشروع "برمجة تطبيقات Google":
    • يمكنك استخدام مشروعك على Google Cloud بدلاً من المشروع التلقائي الذي يتم إنشاؤه تلقائيًا من خلال "برمجة التطبيقات".
    • بالنسبة إلى أي نطاقات أضفتها لإعداد شاشة طلب الموافقة المتعلّقة ببروتوكول OAuth، عليك أيضًا إضافة النطاقات إلى ملف appsscript.json في مشروع "برمجة تطبيقات Google". مثال: 
      • "oauthScopes": [
  "https://www.googleapis.com/auth/chat.messages.readonly"
]
    • تفعيل خدمة Google Workspace Events المتقدّمة

Python

  • Python 3.6 أو أحدث
  • أداة إدارة الحزمة pip
  • أحدث مكتبات عملاء Google للغة Python. لتثبيتها أو تحديثها، شغِّل الأمر التالي في واجهة سطر الأوامر: 
      pip3 install --upgrade google-api-python-client google-auth-oauthlib

  • اشتراك Google Workspace: لإنشاء اشتراك، راجِع إنشاء اشتراك.

  • تتطلب المصادقة:

    • تتطلب مصادقة المستخدم نطاقًا يتيح نوعًا واحدًا على الأقل من أنواع الأحداث للاشتراك. لتحديد نطاق، يُرجى الاطّلاع على النطاقات حسب نوع الحدث.
    • تتطلب مصادقة التطبيقات نطاق chat.bot (تطبيقات Google Chat فقط).

حذف اشتراك مصرَّح به من قِبل المستخدم

يؤدي نموذج الرمز البرمجي التالي إلى حذف مورد Subscription باستخدام مصادقة المستخدم.

لحذف اشتراك، اتّبِع الخطوات التالية:

برمجة تطبيقات

  1. في مشروع برمجة التطبيقات، أنشئ ملف نص برمجي جديدًا باسم deleteSubscription وأضف الرمز التالي:

    function deleteSubscription() {
  // The name of the subscription to delete.
  const name = 'subscriptions/SUBSCRIPTION_ID';

  // Call the Workspace Events API using the advanced service.
  const response = WorkspaceEvents.Subscriptions.remove(name);
  console.log(response);
}

    استبدل ما يلي:

    • SUBSCRIPTION_ID: معرّف الاشتراك للحصول على المعرّف، يمكنك استخدام أي مما يلي:
      • قيمة الحقل uid.
      • رقم تعريف اسم المورد الممثَّل في الحقل name. على سبيل المثال، إذا كان اسم المورد هو subscriptions/subscription-123، استخدِم subscription-123.

  2. لحذف الاشتراك، شغِّل الدالة deleteSubscription في مشروع "برمجة تطبيقات Google".

Python

  1. في دليل العمل، أنشئ ملفًا باسم delete_subscription.py وأضِف الرمز التالي:

    """Delete subscription."""

from google_auth_oauthlib.flow import InstalledAppFlow
from googleapiclient.discovery import build

# Specify required scopes.
SCOPES = ['SCOPE']

# Authenticate with Google Workspace and get user authentication.
flow = InstalledAppFlow.from_client_secrets_file('client_secrets.json', SCOPES)
CREDENTIALS = flow.run_local_server()

# Call the Workspace Events API using the service endpoint.
service = build(
    'workspaceevents',
    'v1',
    credentials=CREDENTIALS,
)

NAME = 'subscriptions/SUBSCRIPTION_ID'
response = service.subscriptions().delete(name=NAME).execute()
print(response)

    استبدل ما يلي:

    • SCOPE: نطاق OAuth يتوافق مع نوع حدث واحد على الأقل من الاشتراك. على سبيل المثال، إذا كان اشتراكك يتلقّى أحداثًا مساحة Chat معدّلة، https://www.googleapis.com/auth/chat.spaces.readonly.
    • SUBSCRIPTION_ID: معرّف الاشتراك للحصول على المعرّف، يمكنك استخدام أي مما يلي:
      • قيمة الحقل uid.
      • رقم تعريف اسم المورد الممثَّل في الحقل name. على سبيل المثال، إذا كان اسم المورد هو subscriptions/subscription-123، استخدِم subscription-123.

  2. في دليل العمل، تأكَّد من حفظ بيانات اعتماد معرِّف عميل OAuth وتسمية الملف client_secrets.json. يستخدم نموذج الرمز ملف JSON هذا للمصادقة باستخدام Google Workspace والحصول على بيانات اعتماد المستخدمين. لمعرفة التعليمات، يُرجى الاطّلاع على إنشاء بيانات اعتماد معرِّف عميل OAuth.

  3. لحذف الاشتراك، يُرجى تنفيذ الإجراء التالي في الوحدة الطرفية:

    python3 delete_subscription.py
تعرض Google Workspace Events API عملية طويلة الأمد تحتوي على مثيل لمورد Subscription.