Method: spaces.messages.update

Aktualizuje wiadomość. Metody patch i update różnią się od siebie. Metoda patch korzysta z żądania patch, a metoda update z żądania 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

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 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 identyfikator niestandardowy, możesz go użyć do określenia komunikatu w żądaniu. W tym celu zastąp {message} wartością z pola clientAssignedMessageId. Na przykład: spaces/AAAAAAAAAAA/messages/client-custom-name. Szczegółowe informacje znajdziesz w sekcji Nadawanie nazwy wiadomościom.

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 zostanie znaleziona, zostanie utworzona nowa wiadomość, a updateMask zostanie zignorowany. Podany identyfikator wiadomości musi być client-assigned. W przeciwnym razie żądanie nie zostanie zrealizowane.

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.