קבלת פרטים על מינוי

במדריך הזה מוסבר איך להשתמש ב-method get במשאב membership של Google Chat API כדי לקבל פרטים על החברות במרחבים משותפים.

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

אימות באמצעות אימות אפליקציות מאפשרת לאפליקציית Chat לקבל מינויים ממרחבים משותפים גישה אליהם ב-Google Chat (למשל, מרחבים שהצטרפת אליהם), אבל לא כוללת מינויים לאפליקציית Chat, כולל האפליקציה שלה. מתבצע אימות עם אימות משתמש מחזירה חברויות ממרחבים משותפים שלמשתמש המאומת יש גישה אליהם.

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

Python

  • Python 3.6 ומעלה
  • הכלי לניהול חבילות pip
  • ספריות הלקוח העדכניות של Google. כדי להתקין או לעדכן אותם, מריצים את הפקודה הבאה בממשק שורת הפקודה: 
    pip3 install --upgrade google-api-python-client google-auth-oauthlib

קבלת פרטים על מינוי

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

  • ב- app authentication, פירוט היקף ההרשאה chat.bot. ב- אימות משתמש, צריך לציין את ההרשאה chat.memberships.readonly או chat.memberships היקף. השיטה המומלצת היא לבחור את ההיקף המגביל ביותר שעדיין שמאפשרות לאפליקציה לפעול.
  • קוראים לפונקציה אמצעי תשלום אחד (get) ב משאב membership.
  • כדי לקבל את ההטבה, עליך להעביר את name מהמינוי. משיגים את שם המינוי מקור המידע של Google Chat.

איך נרשמים למינוי? אימות משתמש:

Python

  1. בספריית העבודה, יוצרים קובץ בשם chat_membership_get.py.

  2. צריך לכלול את הקוד הבא ב-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()

  3. בקוד, מחליפים את מה שכתוב בשדות הבאים:

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

    python3 chat_membership_get.py

Chat API מחזיר מופע של membership שמפרטת את המינוי שצוין.