حذف اشتراك Google Workspace

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

• اشتراك Google Workspace لإنشاء اشتراك، يُرجى الاطّلاع على مقالة إنشاء اشتراك.

• مشروع في برمجة التطبيقات:
  • استخدِم مشروعك على Google Cloud بدلاً من المشروع التلقائي الذي تنشئه "برمجة تطبيقات" تلقائيًا.
  • بالنسبة إلى جميع النطاقات التي أضفتها لإعداد شاشة طلب الموافقة المتعلّقة ببروتوكول OAuth، عليك أيضًا إضافة النطاقات إلى ملف appsscript.json في مشروع "برمجة التطبيقات". على سبيل المثال، إذا حدّدت النطاق chat.messages، أضِف ما يلي:

  "oauthScopes": [
    "https://www.googleapis.com/auth/chat.messages"
  ]
      

  • فعِّل الخدمة المتقدّمة Google Workspace Events.

• يتطلّب المصادقة ونطاق تفويض مناسبًا لكل نوع حدث في الاشتراك:

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

Python

• الإصدار 3.6 أو الإصدارات الأحدث من Python
• أداة إدارة حزم pip
• أحدث مكتبات برامج Google للغة Python لتثبيتها أو تعديلها، شغِّل الأمر التالي في واجهة سطر الأوامر:

    pip3 install --upgrade google-api-python-client google-auth-oauthlib
    

• اشتراك Google Workspace لإنشاء اشتراك، يُرجى الاطّلاع على مقالة إنشاء اشتراك.

• يتطلّب المصادقة ونطاق تفويض مناسبًا لكل نوع حدث في الاشتراك:

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

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

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 في مشروع "برمجة التطبيقات".

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('credentials.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 وأطلِق على الملف الاسم credentials.json. تستخدم عينة التعليمات البرمجية ملف JSON هذا للمصادقة على Google Workspace والحصول على بيانات اعتماد المستخدم. للحصول على التعليمات، يُرجى الاطّلاع على مقالة إنشاء بيانات اعتماد معرّف عميل OAuth .

3. لحذف الاشتراك، شغِّل ما يلي في الوحدة الطرفية:

   python3 delete_subscription.py