Mendapatkan detail tentang langganan

Panduan ini menjelaskan cara menggunakan metode get di resource membership dalam Google Chat API untuk mendapatkan detail tentang langganan dalam ruang.

Resource Membership menunjukkan apakah pengguna manusia atau aplikasi Google Chat diundang ke, sebagian dari, atau tidak ada dalam ruang.

Mengautentikasi dengan autentikasi aplikasi memungkinkan aplikasi Chat mendapatkan keanggotaan dari ruang yang dapat diakses di Google Chat (misalnya, ruang tempatnya menjadi anggota), tetapi tidak termasuk keanggotaan aplikasi Chat, termasuk keanggotaannya sendiri. Mengautentikasi dengan autentikasi pengguna akan menampilkan keanggotaan dari ruang yang dapat diakses oleh pengguna terautentikasi.

Prasyarat

Python

  • Python 3.6 atau yang lebih baru
  • Alat pengelolaan paket pip
  • Library klien Google terbaru untuk Python. Untuk menginstal atau mengupdatenya, jalankan perintah berikut di antarmuka command line Anda:

    pip3 install --upgrade google-api-python-client google-auth-oauthlib
    
  • Project Google Cloud dengan Google Chat API yang diaktifkan dan dikonfigurasi. Untuk mengetahui langkah-langkahnya, lihat Membangun aplikasi Google Chat.
  • Otorisasi yang dikonfigurasi untuk aplikasi Chat. Mendapatkan langganan mendukung kedua metode autentikasi berikut:

Mendapatkan detail tentang langganan

Untuk mendapatkan detail tentang langganan di Google Chat, teruskan hal berikut dalam permintaan Anda:

  • Dengan autentikasi aplikasi, tentukan cakupan otorisasi chat.bot. Saat autentikasi pengguna, tentukan cakupan otorisasi chat.memberships.readonly atau chat.memberships. Sebagai praktik terbaik, pilih cakupan paling ketat yang masih memungkinkan aplikasi Anda berfungsi.
  • Panggil metode get pada resource membership.
  • Teruskan name langganan untuk mendapatkan. Dapatkan nama keanggotaan dari resource langganan Google Chat.

Berikut cara mendapatkan keanggotaan dengan autentikasi pengguna:

Python

  1. Di direktori kerja, buat file bernama chat_membership_get.py.
  2. Sertakan kode berikut di 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. Dalam kode, ganti kode berikut:

  4. Dalam direktori kerja, build dan jalankan contoh:

    python3 chat_membership_get.py
    

Chat API menampilkan instance membership yang memerinci keanggotaan yang ditentukan.