איך מוחקים מרחבים משותפים?

במדריך הזה מוסבר איך משתמשים בשיטה delete במשאב Space של Google Chat API כדי למחוק מרחב משותף עם שם שכבר אין בו צורך. מחיקת מרחב משותף תגרום גם למחיקה של כל מה שהוא מכיל, כולל הודעות וקבצים מצורפים.

המשאב Space מייצג מקום שבו אנשים ואפליקציות של Chat יכולים לשלוח הודעות, לשתף קבצים ולשתף פעולה. יש כמה סוגים של מרחבים משותפים:

• צ'אטים אישיים (DM) הם שיחות בין שני משתמשים או משתמש ואפליקציית Chat.
• צ'אטים קבוצתיים הם שיחות בין שלושה משתמשים או יותר לבין אפליקציות צ'אט.
• מרחבים משותפים עם שמות הם מקומות קבועים שבהם אנשים שולחים הודעות, משתפים קבצים ועובדים יחד.

דרישות מוקדמות

Python

• Python 3.6 ואילך
• הכלי pip לניהול חבילות

• ספריות הלקוח העדכניות של Google ל-Python. כדי להתקין או לעדכן אותן, מריצים את הפקודה הבאה בממשק שורת הפקודה:

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

• פרויקט ב-Google Cloud עם ממשק Google Chat API פעיל ומוגדר. במאמר איך יוצרים אפליקציה ל-Google Chat מוסבר איך עושים זאת.

• הוגדרה הרשאה לאפליקציית Chat. כדי למחוק מרחב משותף, צריך לבצע אימות משתמש עם היקף ההרשאה chat.delete ממשתמש שיש לו הרשאה למחוק את המרחב המשותף.

Node.js

• Node.js ו-npm

• ספריות הלקוח העדכניות של Google ל-Node.js. כדי להתקין אותם, מריצים את הפקודה הבאה בממשק שורת הפקודה:

  npm install @google-cloud/local-auth @googleapis/chat
  

• פרויקט ב-Google Cloud עם ממשק Google Chat API פעיל ומוגדר. במאמר איך יוצרים אפליקציה ל-Google Chat מוסבר איך עושים זאת.

• הוגדרה הרשאה לאפליקציית Chat. כדי למחוק מרחב משותף, צריך לבצע אימות משתמש עם היקף ההרשאה chat.delete ממשתמש שיש לו הרשאה למחוק את המרחב המשותף.

איך מוחקים מרחבים משותפים עם שם

כדי למחוק מרחב משותף קיים ב-Google Chat, צריך להעביר לבקשה את הפרטים הבאים:

• צריך לציין את היקף ההרשאה של chat.delete.
• קוראים ל-method delete במשאב Space.
• מעבירים את name של המרחב המשותף שרוצים למחוק.

כדי למחוק מרחב:

Python

1. בספריית העבודה, יוצרים קובץ בשם chat_space_delete.py.

2. יש לכלול את הקוד הבא ב-chat_space_delete.py:

   from google_auth_oauthlib.flow import InstalledAppFlow
   from googleapiclient.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.delete"]
   
   def main():
       '''
       Authenticates with Chat API via user credentials,
       then deletes the specified space.
       '''
   
       # Authenticate with Google Workspace
       # and get user authorization.
       flow = InstalledAppFlow.from_client_secrets_file(
                         'client_secrets.json', SCOPES)
       creds = flow.run_local_server()
   
       # Build a service endpoint for Chat API.
       chat = build('chat', 'v1', credentials=creds)
   
       # 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. בקוד, מחליפים את SPACE בשם של המרחב המשותף. אפשר לקבל אותו מה-method spaces.list ב-Chat API או מכתובת ה-URL של המרחב המשותף.

4. בספריית העבודה, יוצרים ומריצים את הדוגמה:

   python3 chat_space_delete.py
   

Node.js

1. בספריית העבודה, יוצרים קובץ בשם delete-space.js.

2. יש לכלול את הקוד הבא ב-delete-space.js:

   const chat = require('@googleapis/chat');
   const {authenticate} = require('@google-cloud/local-auth');
   
   /**
   * Deletes a Chat space.
   * @return {!Promise<!Object>}
   */
   async function deleteSpace() {
     const scopes = [
       'https://www.googleapis.com/auth/chat.delete',
     ];
   
     const authClient =
         await authenticate({scopes, keyfilePath: 'client_secrets.json'});
   
     const chatClient = await chat.chat({version: 'v1', auth: authClient});
   
     return await chatClient.spaces.delete({name: 'spaces/SPACE'});
   }
   
   deleteSpace().then(console.log);
   

3. בקוד, מחליפים את SPACE בשם של מרחב משותף, שאותו אפשר לקבל מה-method spaces.list ב-Chat API או מכתובת ה-URL של המרחב המשותף.

4. בספריית העבודה, מריצים את הדוגמה:

   node delete-space.js
   

   אם הפעולה בוצעה בהצלחה, גוף התגובה יהיה ריק, וזה סימן שהמרחב המשותף נמחק.

נושאים קשורים

• איך יוצרים מרחב משותף
• איך מקבלים פרטים על מרחבים משותפים?
• הצגת רשימה של מרחבים משותפים
• איך מעדכנים את המרחב המשותף.
• איך מוחקים מרחבים משותפים?
• איך מגדירים מרחב משותף
• איך מחפשים מרחבים משותפים לצ'אטים אישיים