Method: spaces.messages.patch

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:

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

Żądanie HTTP

PATCH 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 została opublikowana wiadomość, a {message} to identyfikator przypisany przez system tej wiadomości. 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 Nadawanie nazwy wiadomości.

Parametry zapytania

Parametry
updateMask

string (FieldMask format)

Wymagane. Ścieżki pól do zaktualizowania. Oddziel wartości 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 zostanie znaleziona, zostanie utworzona nowa wiadomość, a updateMask zostanie zignorowany. 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 protokołu 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.