איך מזמינים משתמשים, קבוצות ב-Google או אפליקציית Google Chat למרחבים משותפים (original) (raw)

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

אדמינים ב-Google Workspace יכולים להוסיף משתמשים, קבוצות Google או אפליקציות ל-Chat לכל מרחב בארגון שלהם ב-Google Workspace.

המשאבMembershipמייצג אם משתמש אנושי או אפליקציית Google Chat הוזמנו למרחב, הם חלק ממנו או שהם לא נמצאים בו.

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

Node.js

Python

Java

Apps Script

הזמנה או הוספה של משתמש למרחב כמשתמש

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

בדוגמה הבאה מוסיפים משתמש למרחב עם אימות משתמשים:

Node.js

Python

Java

Apps Script

כדי להריץ את הדוגמה, מחליפים את הערכים הבאים:

ה-API של Chat מחזיר מופע שלMembershipשמפרט את חברות המשתמש שנוצרה.

איך מזמינים או מצרפים קבוצות ב-Google למרחבים

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

אי אפשר לצרף קבוצות מ-Google Groups לצ'אטים קבוצתיים או לצ'אטים ישירים, אלא רק למרחבים עם שם.

בדוגמה הבאה מוסיפים קבוצה למרחב עם שם שמוגדר בו אימות משתמשים:

Node.js

Python

Java

Apps Script

כדי להריץ את הדוגמה, מחליפים את הערכים הבאים:

ה-API של Chat מחזיר מופע שלMembershipשמפרט את חברות המשתמש שנוצרה.

איך מוסיפים אפליקציות ל-Chat למרחבים

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

בדוגמה הבאה מוסיפים אפליקציה ל-Chat למרחב:

Node.js

Python

Java

Apps Script

כדי להריץ את הדוגמה, מחליפים את SPACE_NAME במזהה מname של המרחב. אפשר לקבל את המזהה באמצעות הפעלת השיטה ListSpaces() או מכתובת ה-URL של המרחב.

ה-API של Chat מחזיר מופע שלMembershipשמפרט את חברות המשתמש שנוצרה.

הזמנה או הוספה של משתמש למרחב כאפליקציית Chat

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

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

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

בדוגמה הבאה מוסיפים משתמש למרחב עם אימות אפליקציה:

Python

  1. בספריית העבודה, יוצרים קובץ בשם chat_membership_app_create.py.
  2. מוסיפים את הקוד הבא ב-chat_membership_app_create.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.memberships"]  
def main():  
    '''  
    Authenticates with Chat API using app authentication,  
    then adds a user to a Chat space by creating a membership.  
    '''  
    # 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().members().create(  
        # The space in which to create a membership.  
        parent = 'spaces/SPACE',  
        # Specify which user the membership is for.  
        body = {  
          'member': {  
            'name':'users/USER',  
            'type': 'HUMAN'  
          }  
        }  
    ).execute()  
    # Prints details about the created membership.  
    print(result)  
if __name__ == '__main__':  
    main()
  1. בקוד, מחליפים את מה שכתוב בשדות הבאים:
    • ‫SPACE: שם המרחב, שאפשר לקבל באמצעות השיטה spaces.list ב-Chat API, או מכתובת ה-URL של המרחב.
    • ‫USER: מזהה משתמש.
  2. בספריית העבודה, מפתחים ומריצים את הדוגמה:
python3 chat_membership_app_create.py

איך אדמינים ב-Google Workspace מוסיפים משתמשים או קבוצות Google למרחבים

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

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

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

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