יצירת מרחב משותף עם שם ב-Google Chat (original) (raw)

במדריך הזה מוסבר איך ליצור מרחב עם שם באמצעות method‏ create() במשאב Space של Google Chat API.

מרחב עם שם (שבו spaceType הוא SPACE) הוא מקום שבו אנשים שולחים הודעות, משתפים קבצים ועובדים ביחד. מרחבים עם שם יכולים לכלול אפליקציות ל-Chat. למרחבים עם שם יש מנהלי מרחב שיכולים להחיל הגדרות אדמיניסטרטיביות ותיאורים, ולהוסיף או להסיר אנשים ואפליקציות.

כדי ליצור סוגים שונים של מרחבים ב-Chat (כולל צ'אטים ישירים או צ'אטים קבוצתיים), משתמשים בשיטה setUp() במשאב Space כדי ליצור את המרחב ולהוסיף אליו משתתפים בו-זמנית. איך מגדירים מרחב

אחרי שיוצרים מרחב עם שם, המשתמש המאומת הוא המשתמש היחיד במרחב. כדי להוסיף משתמשים למרחב, צריך להפעיל את השיטה create() במשאב Membership עבור כל אדם או אפליקציה שרוצים להוסיף. אפשר גם להשתמש בשיטה setUp() כדי ליצור מרחב עם שם ולהוסיף לו משתתפים בו-זמנית.

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

Node.js

Python

Java

Apps Script

יצירת מרחב עם שם בתור משתמש

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

כך יוצרים מרחב עם שם:

Node.js

Python

Java

Apps Script

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

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

כדי להזמין או להוסיף משתמש למרחב עם אימות אפליקציה, צריך להעביר את הפרטים הבאים בבקשה:

כתיבת סקריפט שקורא ל-Chat API

כך יוצרים מרחב עם שם:

Python

  1. בספריית העבודה, יוצרים קובץ בשם chat_space_create_named_app.py.
  2. מוסיפים את הקוד הבא ב-chat_space_create_named_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.spaces.create"]  
def main():  
    '''  
    Authenticates with Chat API using app authentication,  
    then creates a Chat 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)  
    # Use the service endpoint to call Chat API.  
    result = chat.spaces().create(  
      # Details about the space to create.  
      body = {  
        # To create a named space, set spaceType to SPACE.  
        'spaceType': 'SPACE',  
        # The user-visible name of the space.  
        'displayName': 'API-made',  
        # The customer ID of the Workspace domain.  
        'customer': 'CUSTOMER'  
      }  
      ).execute()  
    # Prints details about the created space.  
    print(result)  
if __name__ == '__main__':  
    main()
  1. בקוד, מחליפים את מה שכתוב בשדות הבאים:
    • ‫CUSTOMER: מזהה הלקוח של הדומיין של המרחב בפורמט customer/{customer}, כאשר {customer} הוא ID ממקור הלקוח של Admin SDK. כדי ליצור מרחב באותו ארגון Google Workspace שבו נמצאת אפליקציית Chat, משתמשים ב-customers/my_customer.
  2. בספריית העבודה, מפתחים ומריצים את הדוגמה:
python3 chat_space_create_named_app.py

פותחים את המרחב ב-Google Chat.

כדי לעבור למרחב, משתמשים במזהה המשאב של המרחב כדי ליצור את כתובת ה-URL של המרחב. אפשר למצוא את מזהה מקור המידע של המרחב name בגוף התגובה של Google Chat. לדוגמה, אם ה-name של המרחב הוא spaces/1234567, אפשר לעבור למרחב באמצעות כתובת ה-URL הבאה: https://mail.google.com/chat/u/0/#chat/space/1234567.

מגבלות ושיקולים