Z tego przewodnika dowiesz się, jak używać metody list
w zasobie Message
interfejsu Google Chat API, aby wyświetlić dzielona na strony listę wiadomości w pokoju z możliwością filtrowania.
W interfejsie Chat API wiadomość z Google Chat jest reprezentowana przez
Message
zasób.
Użytkownicy Google Chat mogą wysyłać tylko wiadomości zawierające tekst,
Aplikacje do obsługi czatu mogą korzystać z wielu innych funkcji wiadomości, w tym
używające statycznych lub interaktywnych interfejsów użytkownika i zbierając informacje z
użytkowników i dostarczanie wiadomości prywatnie. Aby dowiedzieć się więcej o funkcji przesyłania wiadomości
funkcji dostępnych w interfejsie Chat API, zapoznaj się z
Omówienie wiadomości w Google Chat
Wymagania wstępne
Python
- Firmy lub przedsiębiorstwa Konto Google Workspace 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 pod nazwą. ikonę i opis aplikacji Google Chat.
- Zainstaluj Python Biblioteka klienta interfejsów API Google.
-
Utwórz dane logowania na podstawie identyfikatora klienta OAuth dla aplikacji komputerowej. Aby uruchomić próbkę w tym
Przewodnika, zapisz dane logowania w pliku JSON o nazwie
client_secrets.json
katalog lokalny.
- Wybierz zakres autoryzacji, który obsługuje uwierzytelnianie użytkowników.
Wyświetlenie listy wiadomości
Aby wyświetlić listę wiadomości z: uwierzytelnianie użytkownika, w swoim żądaniu:
- Określ zakres autoryzacji
chat.messages.readonly
lubchat.messages
. - Wywołaj funkcję
Metoda
list
wMessage
zasób.
Przykład poniżej zawiera listę wiadomości w pokoju czatu, które zostały wysłane po 16 marca 2023 roku:
Python
- W katalogu roboczym utwórz plik o nazwie
chat_messages_list.py
. Umieść w pliku
chat_messages_list.py
ten kod: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.messages.readonly"] def main(): ''' Authenticates with Chat API via user credentials, then lists messages in a space sent after March 16, 2023. ''' # 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().messages().list( # The space for which to list messages. parent = 'spaces/SPACE', # An optional filter that returns messages # created after March 16, 2023. filter = 'createTime > "2023-03-16T00:00:00-00:00"' ).execute() # Prints the list of messages. print(result) if __name__ == '__main__': main()
W kodzie zastąp
SPACE
nazwą pokoju, która który znajdziesz w Metodaspaces.list
w interfejsie Chat API lub z adresu URL pokoju.W katalogu roboczym skompiluj i uruchom przykład:
python3 chat_messages_list.py
Interfejs Chat API zwraca listę wiadomości wysłanych w określonym pokoju
po 16 marca 2023 r. Jeśli nie ma żadnych komunikatów z prośbą,
Odpowiedź interfejsu Chat API zwraca pusty obiekt. Jeśli używasz tagu
Interfejs REST/HTTP odpowiedź zawiera pusty obiekt JSON, {}
.
Powiązane artykuły
- Formatowanie wiadomości
- Usuwanie wiadomości
- Sprawdzanie szczegółów wiadomości
- Aktualizowanie wiadomości
- Wyślij wiadomość.