במדריך הזה מוסבר איך להשתמש ב-method get
במשאב membership
של Google Chat API כדי לקבל פרטים על החברות במרחבים משותפים.
משאב אחד (Membership
)
מייצג אם בוצעה הזמנה של משתמש אנושי או של אפליקציית Google Chat,
חלק ממרחב מסוים או חסר בו.
אימות באמצעות אימות אפליקציות מאפשרת לאפליקציית Chat לקבל מינויים ממרחבים משותפים גישה אליהם ב-Google Chat (למשל, מרחבים שהצטרפת אליהם), אבל לא כוללת מינויים לאפליקציית Chat, כולל האפליקציה שלה. מתבצע אימות עם אימות משתמש מחזירה חברויות ממרחבים משותפים שלמשתמש המאומת יש גישה אליהם.
דרישות מוקדמות
Python
- עסק או ארגון חשבון Google Workspace עם גישה אל Google Chat.
- Python 3.6 ומעלה
- הכלי לניהול חבילות pip
- ספריות הלקוח העדכניות של Google. כדי להתקין או לעדכן אותם,
מריצים את הפקודה הבאה בממשק שורת הפקודה:
pip3 install --upgrade google-api-python-client google-auth-oauthlib
- מגדירים את הסביבה:
- יוצרים פרויקט ב-Google Cloud.
- מגדירים את מסך ההסכמה של OAuth.
- מפעילים ומגדירים את Google Chat API עם שם, הסמל והתיאור של אפליקציית Chat.
- יוצרים פרטי כניסה לגישה בהתאם לאופן שבו רוצים לבצע אימות בבקשת Google Chat API:
- כדי לבצע אימות כמשתמשי Chat:
יצירת מזהה לקוח ב-OAuth
פרטי כניסה ולשמור את פרטי הכניסה כקובץ JSON בשם
client_secrets.json
לספרייה המקומית שלך. - כדי לבצע אימות כאפליקציית Chat: יצירת חשבון שירות פרטי כניסה לחשבון.
- כדי לבצע אימות כמשתמשי Chat:
יצירת מזהה לקוח ב-OAuth
פרטי כניסה ולשמור את פרטי הכניסה כקובץ JSON בשם
- בוחרים את היקף ההרשאה בהתאם לאופן שבו רוצים לבצע אימות כמשתמשים או אפליקציית Chat.
קבלת פרטים על מינוי
כדי לקבל פרטים על המינוי ב-Google Chat, צריך להעביר את הפרטים הבאים בקשה:
- ב-
app authentication, פירוט
היקף ההרשאה
chat.bot
. ב- אימות משתמש, צריך לציין את ההרשאהchat.memberships.readonly
אוchat.memberships
היקף. השיטה המומלצת היא לבחור את ההיקף המגביל ביותר שעדיין שמאפשרות לאפליקציה לפעול. - קוראים לפונקציה
אמצעי תשלום אחד (
get
) ב משאבmembership
. - כדי לקבל את ההטבה, עליך להעביר את
name
מהמינוי. משיגים את שם המינוי מקור המידע של Google Chat.
איך נרשמים למינוי? אימות משתמש:
Python
- בספריית העבודה, יוצרים קובץ בשם
chat_membership_get.py
. צריך לכלול את הקוד הבא ב-
chat_membership_get.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.memberships.readonly"] def main(): ''' Authenticates with Chat API via user credentials, then gets details about a specified membership. ''' # 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().members().get( # The membership to get. # # Replace SPACE with a space name. # Obtain the space name from the spaces resource of Chat API, # or from a space's URL. # # Replace MEMBER with a membership name. # Obtain the membership name from the memberships resource of # Chat API. name='spaces/SPACE/members/MEMBER' ).execute() # Prints details about the membership. print(result) if __name__ == '__main__': main()
בקוד, מחליפים את מה שכתוב בשדות הבאים:
SPACE
: שם של מרחב, שאפשר לקבל ממנו ה-methodspaces.list
מ-Chat API או מכתובת ה-URL של מרחב משותף.MEMBER
: שם המינוי, שאפשר לקבל מ- אמצעי תשלום אחד (spaces.members.list
) ב-Chat API.
בספריית העבודה, יוצרים ומריצים את הדוגמה:
python3 chat_membership_get.py
Chat API מחזיר מופע של
membership
שמפרטת את המינוי שצוין.
נושאים קשורים
- הצגת רשימת המשתתפים במרחבים משותפים
- איך מזמינים או מוסיפים משתמשים או אפליקציית Chat למרחבים משותפים
- איך מעדכנים את פרטי החברות של משתמשים במרחב משותף ב-Google Chat
- איך מסירים משתמשים או אפליקציית Chat ממרחבים משותפים