Z tego przewodnika dowiesz się, jak użyć metody delete()
w zasobach Message
interfejsu Google Chat API, aby usunąć tekst lub wiadomość z kartą.
W interfejsie Chat API wiadomość w Google Chat jest reprezentowana przez zasób Message
.
Użytkownicy Google Chat mogą wysyłać tylko wiadomości tekstowe, ale aplikacje Google Chat mogą korzystać z wielu innych funkcji wiadomości, w tym wyświetlać statyczne lub interaktywne interfejsy użytkownika, zbierać informacje od użytkowników i wysyłać wiadomości prywatnie. Więcej informacji o funkcjach przesyłania wiadomości dostępnych w interfejsie Chat API znajdziesz w artykule Omówienie wiadomości w Google Chat.
Za pomocą uwierzytelniania aplikacji możesz usunąć wiadomość wysłaną przez aplikację Google Chat. Za pomocą uwierzytelniania użytkownika możesz usunąć wiadomość wysłaną przez uwierzytelnionego użytkownika. Jeśli użytkownik jest menedżerem pokoju, możesz też usunąć wiadomość wysłaną przez innych użytkowników pokoju. Więcej informacji znajdziesz w artykule Więcej informacji o roli menedżera pokoju.
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 swojej 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.
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 swojej 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.
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 swojej 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.
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 swojej aplikacji do obsługi czatu.
- Utwórz samodzielny projekt Apps Script i włącz zaawansowaną usługę Google Chat.
- W tym przewodniku musisz użyć uwierzytelniania użytkownika lub aplikacji. Aby uwierzytelnić się jako aplikacja Google Chat, 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.
Usuwanie wiadomości z uwierzytelnianiem użytkownika
Aby usunąć wiadomość z uwierzytelnianiem użytkownika, prześlij w żądaniu:
- Określ zakres upoważnienia
chat.messages
. - Wywołaj metodę
DeleteMessage()
. - W polu
name
ustaw nazwę zasobu wiadomości, którą chcesz usunąć.
W tym przykładzie wiadomość jest usuwana za pomocą uwierzytelniania 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.MESSAGE_NAME
: identyfikator zname
wiadomości. Identyfikator możesz uzyskać z treści odpowiedzi zwróconej po asynchronicznym utworzeniu wiadomości za pomocą interfejsu Chat API lub za pomocą niestandardowej nazwy przypisanej do wiadomości podczas jej tworzenia.
W przypadku powodzenia treść odpowiedzi jest pusta, co oznacza, że wiadomość została usunięta.
Usuwanie wiadomości z uwierzytelnianiem aplikacji
Aby usunąć wiadomość z uwierzytelnianiem w aplikacji, prześlij w prośbie:
- Określ zakres upoważnienia
chat.bot
. - Wywołaj metodę
DeleteMessage()
. - W polu
name
ustaw nazwę zasobu wiadomości, którą chcesz usunąć.
W tym przykładzie usuwany jest komunikat z uwierzytelnianiem 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.MESSAGE_NAME
: identyfikator zname
wiadomości. Identyfikator możesz uzyskać z treści odpowiedzi zwróconej po asynchronicznym utworzeniu wiadomości za pomocą interfejsu Chat API lub za pomocą niestandardowej nazwy przypisanej do wiadomości podczas jej tworzenia.
W przypadku powodzenia treść odpowiedzi jest pusta, co oznacza, że wiadomość została usunięta.
Powiązane artykuły
- sformatować wiadomość.
- Wyświetlanie szczegółów wiadomości
- Wyświetlanie wiadomości w pokoju.
- Zaktualizuj wiadomość.
- Wyślij wiadomość.