Method: spaces.messages.create

Tworzy wiadomość w pokoju w Google Chat. Przykładowe wiadomości znajdziesz w artykule Tworzenie 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

string

To pole jest wymagane. Nazwa zasobu pokoju, w którym ma zostać utworzona wiadomość.

Format: spaces/{space}

Parametry zapytania

Parametry
threadKey
(deprecated)

string

Opcjonalnie. Wycofane: użyj zasady thread.thread_key. Identyfikator wątku. Obsługuje do 4000 znaków. Aby rozpocząć wątek lub coś do niego dodać, utwórz wiadomość i podaj w niej threadKey lub thread.name. Informacje o używaniu rozwiązania znajdziesz w artykule Rozpoczynanie wątku wiadomości i odpowiadanie na nie.

requestId

string

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

enum (MessageReplyOption)

Opcjonalnie. Określa, czy wiadomość rozpoczyna wątek czy odpowiada na niego. Obsługiwane tylko w pokojach nazwanych.

messageId

string

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 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.
  • Zawiera do 63 znaków i może zawierać tylko małe litery, cyfry i łączniki.
  • jest niepowtarzalna w obrębie pokoju, Aplikacja do obsługi czatu nie może używać tego samego identyfikatora niestandardowego dla różnych wiadomości.

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 threadKey.
REPLY_MESSAGE_FALLBACK_TO_NEW_THREAD Tworzy wiadomość jako odpowiedź w wątku określonym przez zasadę thread ID lub threadKey. 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 threadKey. 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.