Method: spaces.messages.create

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

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

Ten obraz pokazuje, jak Google Chat przypisuje wiadomość, gdy używasz uwierzytelniania 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 akcesoriów (accessoryWidgets).

Wiadomość wysłana z uwierzytelnianiem aplikacji

Ten obraz pokazuje, jak Google Chat przypisuje wiadomość, gdy używasz uwierzytelniania użytkowników. Google Chat wyświetla użytkownika jako nadawcę wiadomości i przypisuje wiadomości do aplikacji, 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 wraz z jej treścią to 32 000 bajtów.

Żą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 ma zostać utworzona wiadomość.

Format: spaces/{space}

Parametry zapytania

Parametry
threadKey
(deprecated)

string

Opcjonalnie: Wycofane: użyj atrybutu thread.thread_key. Identyfikator wątku. Maksymalna długość tekstu to 4000 znaków. Aby rozpocząć wątek lub coś do niego dodać, utwórz wiadomość i podaj 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. Jeśli podasz identyfikator istniejącego żądania, zostanie zwrócona wiadomość utworzona z tym identyfikatorem, zamiast tworzyć nową.

messageReplyOption

enum (MessageReplyOption)

Opcjonalnie: Określa, czy wiadomość rozpoczyna wątek, czy odpowiada w nim. Obsługiwane tylko w przypadku nazwanych pokoi.

messageId

string

Opcjonalnie: Niestandardowy identyfikator wiadomości. Pozwala aplikacjom Google Chat na pobieranie, aktualizowanie i usuwanie wiadomości bez konieczności zapisywania identyfikatora przypisanego przez system 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ć do 63 znaków i tylko małe litery, cyfry oraz łączniki.
  • Jest unikalna w obrębie pokoju. Aplikacja do obsługi czatu nie może używać tego samego niestandardowego identyfikatora dla różnych wiadomości.

Szczegółowe informacje znajdziesz w sekcji Nadawanie nazwy wiadomościom.

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 protokołu 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, 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 powoduje zignorowanie wszystkich uwzględnionych elementów thread ID i threadKey.
REPLY_MESSAGE_FALLBACK_TO_NEW_THREAD Tworzy wiadomość jako odpowiedź w wątku określonym przez thread ID lub threadKey. Jeśli to się nie uda, zostanie otwarta nowy wątek.
REPLY_MESSAGE_OR_FAIL Tworzy wiadomość jako odpowiedź w wątku określonym przez thread ID lub threadKey. Jeśli użyjesz nowego pola threadKey, zostanie utworzony nowy wątek. Jeśli nie uda się utworzyć wiadomości, zamiast tego zostanie zwrócony błąd NOT_FOUND.