Method: spaces.messages.create

Tworzy wiadomość w pokoju Google Chat. Przykład znajdziesz w artykule Wysyłanie wiadomości.

Metoda create() wymaga uwierzytelniania użytkownika lub uwierzytelniania aplikacji. Google Chat przypisuje nadawcę wiadomości w różny sposób w zależności od typu uwierzytelniania użytego w prośbie.

Poniższy obraz pokazuje, jak Google Chat przypisuje wiadomość, gdy używasz uwierzytelnienia aplikacji. Google Chat wyświetla aplikację Google Chat jako nadawca wiadomości. Treść wiadomości może zawierać tekst (text), karty (cardsV2) i widżety dodatkowe (accessoryWidgets).

Wiadomość wysłana z uwierzytelnianiem aplikacji

Na ilustracji poniżej widać, jak Google Chat przypisuje wiadomość, gdy korzystasz z uwierzytelniania użytkownika. Google Chat wyświetla użytkownika jako nadawcę wiadomości i przypisuje do niej aplikację Google Chat, wyświetlając jej nazwę. Treść wiadomości może zawierać tylko tekst (text).

Wiadomość wysłana z uwierzytelnianiem użytkownika

Maksymalny rozmiar wiadomości, w tym jej zawartości, wynosi 32 tys. bajtów.

W przypadku żądań webhooka odpowiedź nie zawiera pełnej wiadomości. W odpowiedzi wypełniane są tylko pola name i thread.name oraz informacje z żądania.

Żądanie HTTP

POST https://chat.googleapis.com/v1/{parent=spaces/*}/messages

Adres URL używa składni transkodowania gRPC.

Parametry ścieżki

Parametry
parent

string

Wymagane. Nazwa zasobu pokoju, w którym chcesz utworzyć wiadomość.

Format: spaces/{space}

Parametry zapytania

Parametry
threadKey
(deprecated)

string

Opcjonalnie: Wycofane: użyj w zastępstwie zasady thread.thread_key. Identyfikator wątku. Obsługuje maksymalnie 4000 znaków. Aby rozpocząć wątek lub dodać do niego wiadomość, utwórz wiadomość i określ threadKey lub thread.name. Przykładowe użycie: Rozpoczynanie wątku wiadomości lub odpowiadanie na niego.
requestId

string

Opcjonalnie: Unikalny identyfikator żądania dla tej wiadomości. Podanie identyfikatora istniejącej prośby spowoduje zwrócenie wiadomości utworzonej z tym identyfikatorem, a nie utworzenie nowej wiadomości.
messageReplyOption

enum (MessageReplyOption)

Opcjonalnie: Określa, czy wiadomość rozpoczyna wątek, czy odpowiada w nim. Obsługiwane są tylko nazwane pokoje.

Gdy reagujesz na interakcje użytkowników, to pole jest ignorowane. W przypadku interakcji w wątku odpowiedź jest tworzona w tym samym wątku. W przeciwnym razie odpowiedź zostanie utworzona jako nowy wątek.
messageId

string

Opcjonalnie: Niestandardowy identyfikator wiadomości. Umożliwia aplikacjom Google Chat pobieranie, aktualizowanie i usuwanie wiadomości bez konieczności przechowywania przypisanego przez system identyfikatora w nazwie zasobu wiadomości (reprezentowanej w polu name wiadomości).

Wartość w tym polu musi spełniać te wymagania:

  • Zaczyna się od client-. Na przykład client-custom-name jest prawidłowym identyfikatorem niestandardowym, ale custom-name już nie.
  • Może zawierać maksymalnie 63 znaki i tylko małe litery, cyfry oraz łączniki.
  • jest niepowtarzalna w obrębie przestrzeni; Aplikacja do czatu nie może używać tego samego niestandardowego identyfikatora w różnych wiadomościach.

Szczegółowe informacje znajdziesz w artykule Nazywanie wiadomości.

Treść żądania

Treść żądania zawiera wystąpienie elementu Message.

Treść odpowiedzi

Jeśli operacja się powiedzie, 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 na temat autoryzacji.

MessageReplyOption

Określa sposób odpowiedzi 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. Ta opcja ignoruje wszystkie uwzględnione wartości thread ID lub threadKey.
REPLY_MESSAGE_FALLBACK_TO_NEW_THREAD Tworzy wiadomość jako odpowiedź na wątek określony przez thread ID lub threadKey. Jeśli się nie uda, wiadomość rozpocznie nowy wątek.
REPLY_MESSAGE_OR_FAIL Tworzy wiadomość jako odpowiedź w wątku określonym przez thread ID lub threadKey. Jeśli użyto nowego threadKey, zostanie utworzony nowy wątek. Jeśli tworzenie wiadomości zakończy się niepowodzeniem, zamiast tego zwrócony zostanie błąd NOT_FOUND.