- Żądanie HTTP
- Parametry ścieżki
- Parametry zapytania
- Treść żądania
- Treść odpowiedzi
- Zakresy autoryzacji
- MessageReplyOption
- Wypróbuj
Tworzy wiadomość w pokoju w Google Chat. Maksymalny rozmiar wiadomości, w tym tekstu i kart, to 32 000 bajtów. Przykład znajdziesz w artykule Wysyłanie wiadomości.
Wywołanie tej metody wymaga uwierzytelniania i obsługuje te typy uwierzytelniania:
- W przypadku SMS-ów obsługiwane jest uwierzytelnianie użytkownika i uwierzytelnianie aplikacji.
- W przypadku wiadomości dotyczących kart obsługiwane jest tylko uwierzytelnianie w aplikacji. (Wiadomości kart mogą tworzyć tylko aplikacje Google Chat).
Żądanie HTTP
POST https://chat.googleapis.com/v1/{parent=spaces/*}/messages
Adres URL używa składni transkodowania gRPC.
Parametry ścieżki
Parametry | |
---|---|
parent |
Wymagane. Nazwa zasobu pokoju, w którym ma zostać utworzona wiadomość. Format: |
Parametry zapytania
Parametry | |
---|---|
threadKey |
Opcjonalnie. Wycofane: użyj zasady |
requestId |
Opcjonalnie. Unikalny identyfikator żądania dla tej wiadomości. Jeśli określisz identyfikator istniejącego żądania, zamiast tworzyć nową wiadomość, zostanie zwrócona wiadomość utworzona z użyciem tego identyfikatora. |
messageReplyOption |
Opcjonalnie. Określa, czy wiadomość rozpoczyna wątek czy odpowiada na niego. Obsługiwane tylko w pokojach nazwanych. |
messageId |
Opcjonalnie. Niestandardowy identyfikator wiadomości. Umożliwia aplikacjom Google Chat pobieranie, aktualizowanie i usuwanie wiadomości bez konieczności zapisywania identyfikatora przypisanego przez system w nazwie zasobu wiadomości (reprezentowanej w polu Wartość w tym polu musi spełniać te wymagania:
Szczegółowe informacje znajdziesz w sekcji Nadawanie nazwy wiadomości. |
Treść żądania
Treść żądania zawiera wystąpienie elementu Message
.
Treść odpowiedzi
Jeśli operacja się uda, treść odpowiedzi będzie zawierała nowo utworzoną instancję Message
.
Zakresy autoryzacji
Wymaga jednego z tych zakresów OAuth:
https://www.googleapis.com/auth/chat.bot
https://www.googleapis.com/auth/chat.import
https://www.googleapis.com/auth/chat.messages
https://www.googleapis.com/auth/chat.messages.create
Więcej informacji znajdziesz w przewodniku po autoryzacji.
MessageReplyOption
Określa, jak odpowiedzieć na wiadomość. W przyszłości możemy dodać więcej stanów.
Wartości w polu enum | |
---|---|
MESSAGE_REPLY_OPTION_UNSPECIFIED |
Domyślny: Rozpoczyna nowy wątek. Użycie tej opcji ignoruje wszystkie uwzględnione elementy thread ID i . |
REPLY_MESSAGE_FALLBACK_TO_NEW_THREAD |
Tworzy wiadomość jako odpowiedź w wątku określonym przez zasadę thread ID lub . W przeciwnym razie wiadomość rozpoczyna nowy wątek. |
REPLY_MESSAGE_OR_FAIL |
Tworzy wiadomość jako odpowiedź w wątku określonym przez zasadę thread ID lub . Jeśli zostanie użyty nowy wątek threadKey , zostanie utworzony nowy wątek. Jeśli nie uda się utworzyć wiadomości, zostanie zwrócony błąd NOT_FOUND . |