حذف مساحة

يشرح هذا الدليل كيفية استخدام الأسلوب delete() في مورد Space من Google Chat API لحذف مساحة مُسمّاة عند عدم الحاجة إليها. يؤدي حذف مساحة إلى حذف كل ما يحتويه ، بما في ذلك الرسائل والمرفقات.

إذا كنت مشرفًا في Google Workspace، يمكنك استدعاء delete() لحذف أي مساحة مُسمّاة في مؤسستك على Google Workspace.

يمثّل مورد Space مكانًا يمكن فيه للمستخدمين وتطبيقات Chat إرسال الرسائل ومشاركة الملفات والتعاون. هناك عدة أنواع من المساحات:

  • الرسائل المباشرة هي محادثات بين مستخدمَين أو مستخدم وأحد تطبيقات Chat.
  • المحادثات الجماعية هي محادثات بين ثلاثة مستخدمين أو أكثر وتطبيقات Chat.
  • المساحات المُسمّاة هي أماكن دائمة يرسل من خلالها المستخدمون الرسائل ويشاركون الملفات ويتعاونون في ما بينها.

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

Node.js

حذف مساحة مُسمّاة بصفتك مستخدمًا

لحذف مساحة حالية في Google Chat باستخدام مصادقة المستخدم، يجب تمرير المعلومات التالية في طلبك:

  • حدِّد نطاق تفويض chat.delete.
  • استدعِ الطريقة DeleteSpace().
  • مرِّر مؤشر الماوس فوق name المساحة المطلوب حذفها.

في ما يلي كيفية حذف مساحة:

Node.js

chat/client-libraries/cloud/delete-space-user-cred.js
import {createClientWithUserCredentials} from './authentication-utils.js';

const USER_AUTH_OAUTH_SCOPES = ['https://www.googleapis.com/auth/chat.delete'];

// This sample shows how to delete a space with user credential
async function main() {
  // Create a client
  const chatClient = await createClientWithUserCredentials(USER_AUTH_OAUTH_SCOPES);

  // Initialize request argument(s)
  const request = {
    // Replace SPACE_NAME here
    name: 'spaces/SPACE_NAME'
  };

  // Make the request
  const response = await chatClient.deleteSpace(request);

  // Handle the response
  console.log(response);
}

main().catch(console.error);

لتنفيذ هذا المثال، استبدِل SPACE_NAME برقم التعريف من حقل name المجموعة. يمكنك الحصول على المعرّف من خلال استدعاء الوسيطة ListSpaces() أو من عنوان URL للمساحة.

حذف مساحة مُعنوَنة كتطبيق Chat

تتطلّب مصادقة التطبيق موافقة المشرف لمرة واحدة.

باستخدام مصادقة التطبيقات، يمكنك فقط حذف المساحات التي تم إنشاؤها من خلال تطبيقات Chat.

لحذف مساحة حالية في Google Chat باستخدام مصادقة التطبيقات، عليك تضمين ما يلي في طلبك:

  • حدِّد نطاق تفويض chat.app.delete.
  • استدعِ طريقة delete في مرجع Space.
  • مرِّر name المساحة المطلوب حذفها.

إنشاء مفتاح واجهة برمجة التطبيقات

لطلب طريقة استخدام واجهة برمجة التطبيقات لمعاينة المطوّر، يجب استخدام إصدار معاينة مطوِّر غير متاح للجميع لمستند Discovery عن واجهة برمجة التطبيقات. ولمصادقة الطلب، عليك تمرير مفتاح واجهة برمجة التطبيقات.

لإنشاء مفتاح واجهة برمجة التطبيقات، افتح مشروع تطبيقك على Google Cloud واتّبِع الخطوات التالية:

  1. في وحدة تحكّم Google Cloud، انتقِل إلى رمز القائمة > واجهات برمجة التطبيقات والخدمات > بيانات الاعتماد.

    الانتقال إلى "بيانات الاعتماد"

  2. انقر على إنشاء بيانات اعتماد > مفتاح واجهة برمجة التطبيقات.
  3. يتم عرض مفتاح واجهة برمجة التطبيقات الجديد.
    • انقر على رمز النسخ لنسخ مفتاح واجهة برمجة التطبيقات لاستخدامه في رمز تطبيقك. يمكن أيضًا العثور على مفتاح واجهة برمجة التطبيقات في قسم "مفاتيح واجهة برمجة التطبيقات" ضمن بيانات اعتماد مشروعك.
    • انقر على تقييد المفتاح لتعديل الإعدادات المتقدّمة والحد من استخدام مفتاح واجهة برمجة التطبيقات. لمزيد من التفاصيل، يُرجى الاطّلاع على فرض قيود على مفاتيح واجهة برمجة التطبيقات.

كتابة نص برمجي يستدعي Chat API

إليك كيفية حذف مساحة:

Python

  1. في دليل العمل، أنشئ ملفًا باسم chat_space_delete_app.py.

  2. أدرِج الرمز التالي في chat_space_delete_app.py:

    from google.oauth2 import service_account
from apiclient.discovery import build

# Define your app's authorization scopes.
# When modifying these scopes, delete the file token.json, if it exists.
SCOPES = ["https://www.googleapis.com/auth/chat.app.delete"]

def main():
    '''
    Authenticates with Chat API using app authentication,
    then deletes the specified space.
    '''

    # Specify service account details.
    creds = (
        service_account.Credentials.from_service_account_file('credentials.json')
        .with_scopes(SCOPES)
    )

    # Build a service endpoint for Chat API.
    chat = build('chat', 'v1', credentials=creds, discoveryServiceUrl='https://chat.googleapis.com/$discovery/rest?version=v1&labels=DEVELOPER_PREVIEW&key=API_KEY')

    # Use the service endpoint to call Chat API.
    result = chat.spaces().delete(

          # The space to delete.
          #
          # Replace SPACE with a space name.
          # Obtain the space name from the spaces resource of Chat API,
          # or from a space's URL.
          name='spaces/SPACE'

      ).execute()

    # Print Chat API's response in your command line interface.
    # When deleting a space, the response body is empty.
    print(result)

if __name__ == '__main__':
    main()

  3. في الرمز، استبدِل ما يلي:

    • API_KEY: مفتاح واجهة برمجة التطبيقات الذي أنشأته لإنشاء نقطة نهاية الخدمة لواجهة برمجة التطبيقات Chat API.

    • SPACE مع اسم المساحة، يمكنك الحصول عليه من spaces.list method في Chat API أو من عنوان URL للمساحة.

  4. في دليل العمل، أنشئ العيّنة وشغِّلها:

    python3 chat_space_delete_app.py

إذا كانت الاستجابة ناجحة، يكون نص الاستجابة فارغًا، ما يشير إلى أنّه تمت حذف المساحة.

حذف مساحة مُسمّاة بصفتك مشرفًا في Google Workspace

إذا كنت مشرفًا في Google Workspace، يمكنك استدعاء الأسلوب DeleteSpace() لحذف أي مساحة مُسمّاة في مؤسستك على Google Workspace.

لاستدعاء هذه الطريقة بصفتك مشرفًا في Google Workspace، اتّبِع الخطوات التالية:

  • استخدِم طريقة المصادقة للمستخدم لطلب الإجراء، وحدِّد نطاق التفويض الذي يتيح طلب الإجراء باستخدام امتيازات المشرف.
  • في طلبك، حدِّد مَعلمة طلب البحث useAdminAccess إلى true.

لمزيد من المعلومات والأمثلة، يُرجى الاطّلاع على مقالة إدارة مساحات Google Chat بصفتك مشرفًا في Google Workspace.