Method: spaces.messages.create

Tworzy wiadomość w pokoju Google Chat. Przykład 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 z kartą obsługiwane jest tylko uwierzytelnianie aplikacji. Tylko aplikacje do obsługi czatu mogą tworzyć karty.

Żą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 atrybutu 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 określ w niej threadKey lub thread.name. Przykłady użycia 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 tym identyfikatorem.
messageReplyOption

enum (MessageReplyOption)

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

string

Opcjonalnie. Niestandardowa nazwa wiadomości w Google Chat przypisana podczas tworzenia. Musi zaczynać się od client- i może zawierać tylko małe litery, cyfry i łączniki o długości do 63 znaków. Określ to pole, aby pobrać, zaktualizować lub usunąć wiadomość o określonej wartości. Nadanie niestandardowej nazwy pozwala aplikacji do obsługi czatu wycofać ją bez zapisywania wiadomości name w treści odpowiedzi zwróconej podczas jej tworzenia. Przypisanie niestandardowej nazwy nie zastępuje wygenerowanego pola name (nazwy zasobu wiadomości). Zamiast tego ustawia ona niestandardową nazwę w polu clientAssignedMessageId, z którego możesz się odwołać podczas późniejszych operacji, takich jak aktualizowanie lub usuwanie wiadomości. Przykłady użycia znajdziesz w artykule Nazywanie 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.

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: Otwiera 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 atrybut 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 atrybut 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.