Z tego przewodnika dowiesz się, jak użyć metody get()
w zasobach Membership
interfejsu Google Chat API, aby uzyskać szczegółowe informacje o członkostwie w pokoju.
Jeśli jesteś administratorem Google Workspace, możesz wywołać metodę get()
, aby pobrać szczegóły dotyczące członkostwa w organizacji Google Workspace.
Membership
Zasób wskazuje, czy użytkownik lub aplikacja Google Chat zostali zaproszeni do pokoju, czy są w nim obecni, czy też są z niego wykluczeni.
Uwierzytelnianie za pomocą uwierzytelniania aplikacji pozwala aplikacji Google Chat uzyskać subskrypcje z pokoi, do których ma dostęp w Google Chat (np. pokoi, których jest członkiem), ale wyklucza subskrypcje aplikacji Google Chat, w tym jej własną. uwierzytelnianie za pomocą uwierzytelniania użytkownika zwraca członkostwa z przestrzeni, do których uwierzytelniony użytkownik ma dostęp.
Wymagania wstępne
Node.js
- Konto Google Workspace w wersji Business lub Enterprise z dostępem do Google Chat.
- Skonfiguruj środowisko:
- Utwórz projekt Google Cloud.
- Skonfiguruj ekran zgody OAuth.
- Włącz i skonfiguruj interfejs Google Chat API, podając nazwę, ikonę i opis aplikacji do obsługi czatu.
- Zainstaluj bibliotekę klienta Cloud dla Node.js.
- Utwórz poświadczenia dostępu na podstawie sposobu uwierzytelniania w żądaniu interfejsu Google Chat API:
- Aby uwierzytelnić się jako użytkownik czatu, utwórz dane logowania OAuth z identyfikatorem klienta i zapisz je w katalogu lokalnym w pliku JSON o nazwie
client_secrets.json
. - Aby uwierzytelnić się jako aplikacja Google Chat, utwórz dane logowania do konta usługi i zapisz je w pliku JSON o nazwie
credentials.json
.
- Aby uwierzytelnić się jako użytkownik czatu, utwórz dane logowania OAuth z identyfikatorem klienta i zapisz je w katalogu lokalnym w pliku JSON o nazwie
- Wybierz zakres autoryzacji w zależności od tego, czy chcesz uwierzytelnić użytkownika czy aplikację Google Chat.
- Pokój Google Chat, którego użytkownik uwierzytelniony lub wywołująca aplikacja Google Chat jest członkiem. Aby uwierzytelnić się jako aplikacja Google Chat, dodaj ją do pokoju.
Python
- Konto Google Workspace w wersji Business lub Enterprise z dostępem do Google Chat.
- Skonfiguruj środowisko:
- Utwórz projekt Google Cloud.
- Skonfiguruj ekran zgody OAuth.
- Włącz i skonfiguruj interfejs Google Chat API, podając nazwę, ikonę i opis aplikacji do obsługi czatu.
- Zainstaluj bibliotekę klienta Cloud w Pythonie.
- Utwórz poświadczenia dostępu na podstawie sposobu uwierzytelniania w żądaniu interfejsu Google Chat API:
- Aby uwierzytelnić się jako użytkownik czatu, utwórz dane logowania OAuth z identyfikatorem klienta i zapisz je w katalogu lokalnym w pliku JSON o nazwie
client_secrets.json
. - Aby uwierzytelnić się jako aplikacja Google Chat, utwórz dane logowania do konta usługi i zapisz je w pliku JSON o nazwie
credentials.json
.
- Aby uwierzytelnić się jako użytkownik czatu, utwórz dane logowania OAuth z identyfikatorem klienta i zapisz je w katalogu lokalnym w pliku JSON o nazwie
- Wybierz zakres autoryzacji w zależności od tego, czy chcesz uwierzytelnić użytkownika czy aplikację Google Chat.
- Pokój Google Chat, którego użytkownik uwierzytelniony lub wywołująca aplikacja Google Chat jest członkiem. Aby uwierzytelnić się jako aplikacja Google Chat, dodaj ją do pokoju.
Java
- Konto Google Workspace w wersji Business lub Enterprise z dostępem do Google Chat.
- Skonfiguruj środowisko:
- Utwórz projekt Google Cloud.
- Skonfiguruj ekran zgody OAuth.
- Włącz i skonfiguruj interfejs Google Chat API, podając nazwę, ikonę i opis aplikacji do obsługi czatu.
- Zainstaluj bibliotekę klienta Cloud w Javie.
- Utwórz poświadczenia dostępu na podstawie sposobu uwierzytelniania w żądaniu interfejsu Google Chat API:
- Aby uwierzytelnić się jako użytkownik czatu, utwórz dane logowania OAuth z identyfikatorem klienta i zapisz je w katalogu lokalnym w pliku JSON o nazwie
client_secrets.json
. - Aby uwierzytelnić się jako aplikacja Google Chat, utwórz dane logowania do konta usługi i zapisz je w pliku JSON o nazwie
credentials.json
.
- Aby uwierzytelnić się jako użytkownik czatu, utwórz dane logowania OAuth z identyfikatorem klienta i zapisz je w katalogu lokalnym w pliku JSON o nazwie
- Wybierz zakres autoryzacji w zależności od tego, czy chcesz uwierzytelnić użytkownika czy aplikację Google Chat.
- Pokój Google Chat, którego użytkownik uwierzytelniony lub wywołująca aplikacja Google Chat jest członkiem. Aby uwierzytelnić się jako aplikacja Google Chat, dodaj ją do pokoju.
Google Apps Script
- Konto Google Workspace w wersji Business lub Enterprise z dostępem do Google Chat.
- Skonfiguruj środowisko:
- Utwórz projekt Google Cloud.
- Skonfiguruj ekran zgody OAuth.
- Włącz i skonfiguruj interfejs Google Chat API, podając nazwę, ikonę i opis aplikacji do obsługi czatu.
- Utwórz samodzielny projekt Apps Script i włącz zaawansowaną usługę czatu.
- W tym przewodniku musisz użyć uwierzytelniania użytkownika lub aplikacji. Aby uwierzytelnić się jako aplikacja czatu, utwórz dane logowania konta usługi. Instrukcje znajdziesz w artykule Uwierzytelnianie i autoryzowanie jako aplikacja Google Chat.
- Wybierz zakres autoryzacji w zależności od tego, czy chcesz uwierzytelnić użytkownika czy aplikację Google Chat.
- Pokój Google Chat, którego użytkownik uwierzytelniony lub wywołująca aplikacja Google Chat jest członkiem. Aby uwierzytelnić się jako aplikacja Google Chat, dodaj ją do pokoju.
Sprawdzanie szczegółów subskrypcji
Aby uzyskać szczegółowe informacje o usłudze Google Chat, w żądaniu podaj:
- W przypadku uwierzytelniania aplikacji określ zakres autoryzacji
chat.bot
. W przypadku uwierzytelniania użytkownika określ zakres uprawnieńchat.memberships.readonly
lubchat.memberships
. Najlepiej wybrać najbardziej restrykcyjny zakres, który nadal pozwoli aplikacji na działanie. - Wywołaj metodę
GetMembership()
. - Przekaż
name
, aby uzyskać dostęp. Uzyskaj nazwę członkostwa z zasobu członkostwa Google Chat.
Uzyskaj członkostwo dzięki uwierzytelnianiu użytkownika
Aby uzyskać subskrypcję z weryfikacją tożsamości użytkownika:
Node.js
Python
Java
Google Apps Script
Aby uruchomić ten przykład, zastąp:
SPACE_NAME
: identyfikatorname
pokoju. Identyfikator możesz uzyskać, wywołując metodęListSpaces()
lub z adresu URL pokoju.MEMBER_NAME
: identyfikator użytkownika wname
. Identyfikator możesz uzyskać, wywołując metodęListMemberships()
.
Interfejs Chat API zwraca instancję Membership
, która zawiera szczegóły określonego członkostwa.
Uzyskaj członkostwo dzięki uwierzytelnianiu w aplikacji
Aby uzyskać subskrypcję za pomocą uwierzytelniania w aplikacji:
Node.js
Python
Java
Google Apps Script
Aby uruchomić ten przykład, zastąp:
SPACE_NAME
: identyfikatorname
pokoju. Identyfikator możesz uzyskać, wywołując metodęListSpaces()
lub z adresu URL pokoju.MEMBER_NAME
: identyfikator użytkownika wname
. Identyfikator możesz uzyskać, wywołując metodęListMemberships()
.
Interfejs Chat API zwraca instancję Membership
, która zawiera szczegóły określonego członkostwa.
Więcej informacji o subskrypcjach w Google Workspace
Jeśli jesteś administratorem Google Workspace, możesz wywołać metodę GetMembership()
, aby pobrać szczegóły dotyczące członkostwa dowolnego użytkownika w organizacji Google Workspace.
Aby wywołać tę metodę jako administrator Google Workspace:
- Wywołaj metodę, używając uwierzytelniania użytkownika, i określ zakres autoryzacji, który obsługuje wywoływanie metody przy użyciu uprawnień administratora.
- W żądaniu ustaw parametr zapytania
useAdminAccess
natrue
.
Więcej informacji i przykłady znajdziesz w artykule Zarządzanie pokojami Google Chat przez administratora Google Workspace.
Powiązane artykuły
- Wyświetlanie listy osób w pokoju.
- Zapraszanie użytkownika lub aplikacji Google Chat do pokoju
- Aktualizowanie członkostwa użytkownika w pokoju Google Chat
- Usuwanie użytkownika lub aplikacji Google Chat z pokoju.