במדריך הזה מוסבר איך משתמשים
delete()
במשאב Space
ב-Google Chat API כדי למחוק מרחב משותף עם שם
שהוא כבר לא נחוץ. כשמוחקים מרחב משותף, גם כל התוכן שלו נמחק
שמכיל, כולל הודעות וקבצים מצורפים.
אדמינים ב-Google Workspace יכולים להתקשר אל delete()
.
שמוחקים מרחב משותף עם שם בארגון ב-Google Workspace.
המשאבים מסוג Space
מייצגים מקום שבו אנשים ואפליקציות של Chat יכולים לשלוח הודעות, לשתף קבצים ולשתף פעולה. יש כמה סוגים של מרחבים משותפים:
- צ'אטים ישירים הם שיחות בין שני משתמשים או משתמש, אפליקציה ל-Chat.
- צ'אטים קבוצתיים הם שיחות בין שלושה משתמשים או יותר, אפליקציות צ'אט.
- מרחבים עם שם הם מקומות קבועים שבהם אנשים שולחים הודעות, משתפים קבצים, ולשתף פעולה.
דרישות מוקדמות
Node.js
- עסק או ארגון חשבון Google Workspace עם גישה אל Google Chat.
- מגדירים את הסביבה:
- יוצרים פרויקט ב-Google Cloud.
- מגדירים את מסך ההסכמה של OAuth.
- מפעילים ומגדירים את Google Chat API עם שם, סמל ותיאור לאפליקציית Chat.
- מתקינים את ספריית הלקוח של Cloud ל-Node.js.
-
יוצרים פרטי כניסה למזהה הלקוח ב-OAuth לאפליקציה למחשב. כדי להריץ את הדוגמה במדריך הזה, שומרים את פרטי הכניסה כקובץ JSON בשם
client_secrets.json
בספרייה המקומית.
- בחירת היקף הרשאה שתומך באימות משתמשים.
- מרחב משותף ב-Google Chat. במאמר יצירת מרחב משותף מוסבר איך ליצור מרחב משותף באמצעות Google Chat API. כדי ליצור הודעה ב-Chat: אפשר להיכנס אל מאמר במרכז העזרה.
מחיקת מרחב משותף בעל שם כמשתמשים
כדי למחוק מרחב משותף קיים ב-Google Chat עם אימות משתמש, אישור את הפרטים הבאים בבקשה שלכם:
- מציינים את היקף ההרשאה
chat.delete
. - קוראים ל-method
DeleteSpace()
. - כדי למחוק את המרחב המשותף, מעבירים את
name
של המרחב המשותף.
כך מוחקים מרחב משותף:
Node.js
כדי להריץ את הדוגמה הזו, צריך להחליף את 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 ומבצעים את הפעולות הבאות:
- במסוף Google Cloud, נכנסים לתפריט > ממשקי API ו Services (שירותים) > פרטי כניסה.
- לוחצים על יצירת פרטי כניסה >. API key.
- מפתח ה-API החדש מוצג.
- לוחצים על 'העתקה' . כדי להעתיק את מפתח ה-API לשימוש בקוד של האפליקציה. מפתח ה-API יכול להיות גם נמצא ב'מפתחות API'. בפרטי הכניסה של הפרויקט.
- לוחצים על Restrict key כדי לעדכן את ההגדרות המתקדמות ולהגביל את השימוש. של מפתח ה-API. מידע נוסף זמין במאמר החלת הגבלות על מפתחות API.
כתיבת סקריפט שקורא ל-Chat API
כך מוחקים מרחב משותף:
Python
- בספריית העבודה, יוצרים קובץ בשם
chat_space_delete_app.py
. צריך לכלול את הקוד הבא ב-
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()
בקוד, מחליפים את הפרטים הבאים:
API_KEY
: מפתח ה-API שיצרתם כדי ליצור נקודת הקצה של השירות ל-Chat API.SPACE
בשם המרחב המשותף. אפשר לקבל את השם מהשיטהspaces.list
ב-Chat API או מכתובת ה-URL של המרחב המשותף.
בספריית העבודה, יוצרים ומריצים את הדוגמה:
python3 chat_space_delete_app.py
אם הפעולה בוצעה ללא שגיאות, גוף התגובה יהיה ריק, מה שמציין שהרווח נמחק.
איך מוחקים מרחב משותף עם שם כאדמין ב-Google Workspace
אדמינים ב-Google Workspace יכולים להתקשר אל
שיטה DeleteSpace()
למחיקת כל מרחב משותף עם שם
ארגון ב-Google Workspace.
כדי להפעיל את השיטה הזו כאדמינים ב-Google Workspace, מבצעים את הפעולות הבאות:
- קוראים ל-method באמצעות אימות משתמש ומציינים היקף ההרשאה שתומך בקריאה לשיטה באמצעות הרשאות אדמין.
- בבקשה שלכם, מציינים את פרמטר השאילתה
useAdminAccess
עדtrue
.
מידע נוסף ודוגמאות זמינים במאמר ניהול מרחבים ב-Google Chat בתור אדמינים ב-Google Workspace
נושאים קשורים
- איך יוצרים מרחבים משותפים
- איך מקבלים פרטים על מרחבים משותפים?
- הצגת רשימה של מרחבים
- לעדכן מרחב משותף.
- איך מוחקים מרחבים משותפים
- איך מגדירים מרחב משותף.
- איך מחפשים מרחבים משותפים בצ'אטים ישירים