جزئیات عضویت را دریافت کنید

این راهنما نحوه استفاده از متد get() در منبع membership Google Chat API برای دریافت جزئیات عضویت در یک فضا توضیح می‌دهد.

اگر یک سرپرست Google Workspace هستید، می‌توانید برای بازیابی جزئیات هر عضویت در سازمان Google Workspace خود، روش get() فراخوانی کنید.

منبع Membership نشان می‌دهد که آیا کاربر انسانی یا برنامه چت Google به یک فضا دعوت شده، بخشی از آن یا غایب است.

احراز هویت با احراز هویت برنامه به برنامه Chat امکان می‌دهد از فضاهایی که در Google Chat به آن‌ها دسترسی دارد (مثلاً فضاهایی که عضو آن است)، عضویت دریافت کند، اما عضویت‌های برنامه Chat، از جمله خود، را استثنا نمی‌کند. احراز هویت با احراز هویت کاربر ، عضویت ها را از فضاهایی که کاربر احراز هویت شده به آنها دسترسی دارد، برمی گرداند.

پیش نیازها

پایتون

جزئیات عضویت را دریافت کنید

برای دریافت جزئیات عضویت در Google Chat، موارد زیر را در درخواست خود بنویسید:

  • با احراز هویت برنامه ، محدوده مجوز chat.bot را مشخص کنید. با احراز هویت کاربر ، محدوده مجوز chat.memberships.readonly یا chat.memberships را مشخص کنید. به عنوان بهترین روش، محدودترین محدوده را انتخاب کنید که همچنان به برنامه شما اجازه عملکرد می دهد.
  • در منبع membership ، get() فراخوانی کنید.
  • برای دریافت name عضویت را ارسال کنید. نام عضویت را از منبع عضویت Google Chat دریافت کنید.

در اینجا نحوه دریافت عضویت با احراز هویت کاربر آورده شده است:

پایتون

  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. در کد زیر را جایگزین کنید:

    • SPACE : نام فضایی است که می توانید از روش spaces.list در Chat API یا از URL یک فضا دریافت کنید.
    • MEMBER : یک نام عضویت که می توانید از روش spaces.members.list در Chat API دریافت کنید.
  4. در پوشه کاری خود، نمونه را بسازید و اجرا کنید:

    python3 chat_membership_get.py

Chat API نمونه ای از membership با جزئیات عضویت مشخص شده برمی گرداند.

جزئیات عضویت را به عنوان سرپرست Google Workspace دریافت کنید

اگر یک سرپرست Google Workspace هستید، می‌توانید برای بازیابی جزئیات عضویت برای هر کاربر در سازمان Google Workspace، روش get() را فراخوانی کنید.

برای فراخوانی این روش به عنوان سرپرست Google Workspace، موارد زیر را انجام دهید:

  • روش را با استفاده از احراز هویت کاربر فراخوانی کنید و محدوده مجوزی را مشخص کنید که از فراخوانی روش با استفاده از امتیازات سرپرست پشتیبانی می کند.
  • در درخواست خود، پارامتر query useAdminAccess به true مشخص کنید.

برای اطلاعات بیشتر و مثال‌ها، به مدیریت فضاهای گپ Google به عنوان سرپرست Google Workspace مراجعه کنید.

،

این راهنما نحوه استفاده از متد get() در منبع membership Google Chat API برای دریافت جزئیات عضویت در یک فضا توضیح می‌دهد.

اگر یک سرپرست Google Workspace هستید، می‌توانید برای بازیابی جزئیات هر عضویت در سازمان Google Workspace خود، روش get() فراخوانی کنید.

منبع Membership نشان می‌دهد که آیا کاربر انسانی یا برنامه چت Google به یک فضا دعوت شده، بخشی از آن یا غایب است.

احراز هویت با احراز هویت برنامه به برنامه Chat امکان می‌دهد از فضاهایی که در Google Chat به آن‌ها دسترسی دارد (مثلاً فضاهایی که عضو آن است)، عضویت دریافت کند، اما عضویت‌های برنامه Chat، از جمله خود، را استثنا نمی‌کند. احراز هویت با احراز هویت کاربر ، عضویت ها را از فضاهایی که کاربر احراز هویت شده به آنها دسترسی دارد، برمی گرداند.

پیش نیازها

پایتون

جزئیات عضویت را دریافت کنید

برای دریافت جزئیات عضویت در Google Chat، موارد زیر را در درخواست خود بنویسید:

  • با احراز هویت برنامه ، محدوده مجوز chat.bot را مشخص کنید. با احراز هویت کاربر ، محدوده مجوز chat.memberships.readonly یا chat.memberships را مشخص کنید. به عنوان بهترین روش، محدودترین محدوده را انتخاب کنید که همچنان به برنامه شما اجازه عملکرد می دهد.
  • در منبع membership ، get() فراخوانی کنید.
  • برای دریافت name عضویت را ارسال کنید. نام عضویت را از منبع عضویت Google Chat دریافت کنید.

در اینجا نحوه دریافت عضویت با احراز هویت کاربر آورده شده است:

پایتون

  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. در کد زیر را جایگزین کنید:

    • SPACE : نام فضایی است که می توانید از روش spaces.list در Chat API یا از URL یک فضا دریافت کنید.
    • MEMBER : یک نام عضویت که می توانید از روش spaces.members.list در Chat API دریافت کنید.
  4. در پوشه کاری خود، نمونه را بسازید و اجرا کنید:

    python3 chat_membership_get.py

Chat API نمونه ای از membership با جزئیات عضویت مشخص شده برمی گرداند.

جزئیات عضویت را به عنوان سرپرست Google Workspace دریافت کنید

اگر یک سرپرست Google Workspace هستید، می‌توانید برای بازیابی جزئیات عضویت برای هر کاربر در سازمان Google Workspace، روش get() را فراخوانی کنید.

برای فراخوانی این روش به عنوان سرپرست Google Workspace، موارد زیر را انجام دهید:

  • روش را با استفاده از احراز هویت کاربر فراخوانی کنید و محدوده مجوزی را مشخص کنید که از فراخوانی روش با استفاده از امتیازات سرپرست پشتیبانی می کند.
  • در درخواست خود، پارامتر query useAdminAccess به true مشخص کنید.

برای اطلاعات بیشتر و مثال‌ها، به مدیریت فضاهای گپ Google به عنوان سرپرست Google Workspace مراجعه کنید.

،

این راهنما نحوه استفاده از متد get() در منبع membership Google Chat API برای دریافت جزئیات عضویت در یک فضا توضیح می‌دهد.

اگر یک سرپرست Google Workspace هستید، می‌توانید برای بازیابی جزئیات هر عضویت در سازمان Google Workspace خود، روش get() فراخوانی کنید.

منبع Membership نشان می‌دهد که آیا کاربر انسانی یا برنامه چت Google به یک فضا دعوت شده، بخشی از آن یا غایب است.

احراز هویت با احراز هویت برنامه به برنامه Chat امکان می‌دهد از فضاهایی که در Google Chat به آن‌ها دسترسی دارد (مثلاً فضاهایی که عضو آن است)، عضویت دریافت کند، اما عضویت‌های برنامه Chat، از جمله خود، را استثنا نمی‌کند. احراز هویت با احراز هویت کاربر ، عضویت ها را از فضاهایی که کاربر احراز هویت شده به آنها دسترسی دارد، برمی گرداند.

پیش نیازها

پایتون

جزئیات عضویت را دریافت کنید

برای دریافت جزئیات عضویت در Google Chat، موارد زیر را در درخواست خود بنویسید:

  • با احراز هویت برنامه ، محدوده مجوز chat.bot را مشخص کنید. با احراز هویت کاربر ، محدوده مجوز chat.memberships.readonly یا chat.memberships را مشخص کنید. به عنوان بهترین روش، محدودترین محدوده را انتخاب کنید که همچنان به برنامه شما اجازه عملکرد می دهد.
  • در منبع membership ، get() فراخوانی کنید.
  • برای دریافت name عضویت را ارسال کنید. نام عضویت را از منبع عضویت Google Chat دریافت کنید.

در اینجا نحوه دریافت عضویت با احراز هویت کاربر آورده شده است:

پایتون

  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. در کد زیر را جایگزین کنید:

    • SPACE : نام فضایی است که می توانید از روش spaces.list در Chat API یا از URL یک فضا دریافت کنید.
    • MEMBER : یک نام عضویت که می توانید از روش spaces.members.list در Chat API دریافت کنید.
  4. در پوشه کاری خود، نمونه را بسازید و اجرا کنید:

    python3 chat_membership_get.py

Chat API نمونه ای از membership با جزئیات عضویت مشخص شده برمی گرداند.

جزئیات عضویت را به عنوان سرپرست Google Workspace دریافت کنید

اگر یک سرپرست Google Workspace هستید، می‌توانید برای بازیابی جزئیات عضویت برای هر کاربر در سازمان Google Workspace، روش get() را فراخوانی کنید.

برای فراخوانی این روش به عنوان سرپرست Google Workspace، موارد زیر را انجام دهید:

  • روش را با استفاده از احراز هویت کاربر فراخوانی کنید و محدوده مجوزی را مشخص کنید که از فراخوانی روش با استفاده از امتیازات سرپرست پشتیبانی می کند.
  • در درخواست خود، پارامتر query useAdminAccess به true مشخص کنید.

برای اطلاعات بیشتر و مثال‌ها، به مدیریت فضاهای گپ Google به عنوان سرپرست Google Workspace مراجعه کنید.