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

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

אדמינים ב-Google Workspace יכולים להתקשר אל delete(). שמוחקים מרחב משותף עם שם בארגון ב-Google Workspace.

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

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

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

Node.js

מחיקת מרחב משותף בעל שם כמשתמשים

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

  • מציינים את היקף ההרשאה chat.delete.
  • קוראים ל-method‏ 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 השדה הזה. אפשר לקבל את המזהה על ידי קריאה ל-method‏ ListSpaces() או מכתובת ה-URL של המרחב המשותף.

מחיקה של מרחב משותף בעל שם כאפליקציית Chat

נדרש אימות חד-פעמי של אפליקציות אישור אדמין.

כשמפעילים אימות אפליקציות אפשר למחוק רק מרחבים משותפים שנוצרו על ידי אפליקציות צ'אט.

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

  • מציינים את היקף ההרשאה chat.app.delete.
  • קוראים לפונקציה שיטת delete במשאב Space.
  • כדי למחוק את המרחב המשותף, מעבירים את name של המרחב המשותף.

יצירה של מפתח API

כדי לקרוא ל-method של API בתצוגה מקדימה למפתחים, צריך להשתמש בגרסה לא ציבורית של מסמך חשיפת ה-API בתצוגה מקדימה למפתחים. כדי לאמת את הבקשה, צריך להעביר מפתח API.

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

  1. במסוף Google Cloud, נכנסים לתפריט > ממשקי API ו Services (שירותים) > פרטי כניסה.

    כניסה לדף Credentials

  2. לוחצים על יצירת פרטי כניסה >. API key.
  3. מפתח ה-API החדש מוצג.
    • לוחצים על 'העתקה' . כדי להעתיק את מפתח ה-API לשימוש בקוד של האפליקציה. מפתח ה-API יכול להיות גם נמצא ב'מפתחות API'. בפרטי הכניסה של הפרויקט.
    • לוחצים על Restrict key כדי לעדכן את ההגדרות המתקדמות ולהגביל את השימוש. של מפתח ה-API. מידע נוסף זמין במאמר החלת הגבלות על מפתחות API.

כתיבת סקריפט שקורא ל-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: מפתח ה-API שיצרתם כדי ליצור נקודת הקצה של השירות ל-Chat API.

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

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

    python3 chat_space_delete_app.py

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

איך מוחקים מרחב משותף עם שם כאדמין ב-Google Workspace

אדמינים ב-Google Workspace יכולים להתקשר אל שיטה DeleteSpace() למחיקת כל מרחב משותף עם שם ארגון ב-Google Workspace.

כדי להפעיל את השיטה הזו כאדמינים ב-Google Workspace, מבצעים את הפעולות הבאות:

  • קוראים ל-method באמצעות אימות משתמש ומציינים היקף ההרשאה שתומך בקריאה לשיטה באמצעות הרשאות אדמין.
  • בבקשה שלכם, מציינים את פרמטר השאילתה useAdminAccess עד true.

מידע נוסף ודוגמאות זמינים במאמר ניהול מרחבים ב-Google Chat בתור אדמינים ב-Google Workspace