Method: spaces.messages.update

Aktualizuje wiadomość. Metody patch i update różnią się od siebie. Metoda patch używa żądania patch, a metoda update – put. Zalecamy użycie metody patch. Przykład znajdziesz w sekcji Aktualizowanie wiadomości.

Obsługuje te typy uwierzytelniania:

  • Uwierzytelnianie aplikacji z zakresem autoryzacji:

    • https://www.googleapis.com/auth/chat.bot

  • Uwierzytelnianie użytkownika za pomocą jednego z tych zakresów autoryzacji:

    • https://www.googleapis.com/auth/chat.messages
    • https://www.googleapis.com/auth/chat.import (tylko pokoje w trybie importowania)

Gdy używasz uwierzytelniania aplikacji, żądania mogą aktualizować tylko wiadomości utworzone przez wywołującą aplikację Google Chat.

Żądanie HTTP

PUT https://chat.googleapis.com/v1/{message.name=spaces/*/messages/*}

Adres URL używa składni transkodowania gRPC.

Parametry ścieżki

Parametry
message.name

string

Identyfikator. Nazwa zasobu wiadomości.

Format: spaces/{space}/messages/{message}

Gdzie {space} to identyfikator pokoju, w którym opublikowano wiadomość, a {message} to przypisany do niej identyfikator systemu. Na przykład: spaces/AAAAAAAAAAA/messages/BBBBBBBBBBB.BBBBBBBBBBB.

Jeśli podczas tworzenia wiadomości ustawisz niestandardowy identyfikator, możesz użyć tego identyfikatora do określenia wiadomości w żądaniu, zastępując {message} wartością z pola clientAssignedMessageId. Na przykład: spaces/AAAAAAAAAAA/messages/client-custom-name. Szczegółowe informacje znajdziesz w artykule Nazywanie wiadomości.

Parametry zapytania

Parametry
updateMask

string (FieldMask format)

Wymagane. Ścieżki pól do zaktualizowania. Jeśli jest wiele wartości, rozdziel je przecinkami lub użyj *, aby zaktualizować wszystkie ścieżki pól.

Obecnie obsługiwane ścieżki pól:
allowMissing

boolean

Opcjonalnie. Jeśli true i wiadomość nie zostaną znalezione, zostanie utworzona nowa wiadomość, a wartość updateMask zostanie zignorowana. Podany identyfikator wiadomości musi być przypisany przez klienta. W przeciwnym razie żądanie się nie powiedzie.

Treść żądania

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

Treść odpowiedzi

W przypadku powodzenia treść odpowiedzi obejmuje wystąpienie elementu 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

Więcej informacji znajdziesz w przewodniku dotyczącym autoryzacji.