Method: spaces.messages.create

Utworzenie wiadomości w pokoju Google Chat. Przykład znajdziesz w sekcji Tworzenie wiadomości.

Wywołanie tej metody wymaga uwierzytelniania i obsługuje te typy uwierzytelniania:

  • Uwierzytelnianie SMS-ów i aplikacji jest obsługiwane.
  • W przypadku wiadomości na karcie obsługiwane jest tylko uwierzytelnianie aplikacji. (Tylko aplikacje do obsługi czatu mogą tworzyć wiadomości na karcie).

Żą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

Wymagany. Nazwa zasobu pokoju, w którym zostanie utworzona wiadomość.

Format: spaces/{space}

Parametry zapytania

Parametry
threadKey
(deprecated)

string

Opcjonalnie. Wycofane: użyj thread.thread_key. Identyfikator wątku. Obsługuje do 4000 znaków. Aby rozpocząć lub dodać wątek, utwórz wiadomość i wskaż threadKey lub thread.name. Więcej informacji znajdziesz w artykule Rozpoczynanie wątku wiadomości i odpowiadanie na niego.
requestId

string

Opcjonalnie. Unikalny identyfikator tej wiadomości. Określenie istniejącego identyfikatora żądania powoduje zwrócenie wiadomości utworzonej przy użyciu tego identyfikatora zamiast tworzenia nowej.
messageReplyOption

enum (MessageReplyOption)

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

string

Opcjonalnie. Niestandardowa nazwa wiadomości w Google Chat podczas tworzenia. Musi zaczynać się od client- i zawierać tylko małe litery, cyfry oraz łączniki o długości do 63 znaków. Określ to pole, aby pobrać, zaktualizować lub usunąć wiadomość o określonej wartości. Przypisywanie niestandardowej nazwy powoduje, że aplikacja Google Chat zapamiętuje wiadomość bez zapisywania jej name z treści odpowiedzi zwróconej podczas jej tworzenia. Przypisanie niestandardowej nazwy nie zastępuje wygenerowanego pola name, czyli nazwy zasobu wiadomości. Zamiast tego ustawia nazwę niestandardową w polu clientAssignedMessageId, do którego można się odwoływać podczas późniejszych operacji, takich jak aktualizowanie czy usuwanie wiadomości. Więcej informacji znajdziesz w artykule Nadawanie nazwy utworzonej 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.

Opcja odpowiedzi w wiadomości

Określa sposób odpowiadania 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 wątek.
REPLY_MESSAGE_FALLBACK_TO_NEW_THREAD Tworzy wiadomość w odpowiedzi na wątek określony przez użytkownika thread ID lub threadKey. Jeśli to nie pomoże, wiadomość zostanie utworzona w nowym wątku.
REPLY_MESSAGE_OR_FAIL Tworzy wiadomość w odpowiedzi na wątek określony przez użytkownika thread ID lub threadKey. Jeśli operacja się nie powiedzie, zostanie zwrócony błąd NOT_FOUND.