Method: spaces.messages.patch

Aktualizuje wiadomość. Istnieje różnica między metodami patch i update. Metoda patch używa żądania patch, a metoda update – żądania put. Zalecamy użycie metody patch. Więcej informacji znajdziesz w artykule Aktualizowanie wiadomości.

Wymaga uwierzytelniania. Obsługuje uwierzytelnianie aplikacji i uwierzytelnianie użytkowników. Gdy korzystasz z 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

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 do wiadomości. Na przykład: spaces/AAAAAAAAAAA/messages/BBBBBBBBBBB.BBBBBBBBBBB.

Jeśli podczas tworzenia wiadomości ustawisz identyfikator niestandardowy, możesz go użyć, aby określić treść żądania. 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ści.

Parametry zapytania

Parametry
updateMask

string (FieldMask format)

To pole jest wymagane. Ścieżki pól do zaktualizowania. Poszczególne wartości rozdziel przecinkami lub użyj funkcji *, aby zaktualizować ścieżki wszystkich pól.

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

allowMissing

boolean

Opcjonalnie. Jeśli true nie może znaleźć wiadomości, zostanie utworzona nowa wiadomość, a pole updateMask zostanie zignorowane. 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 po autoryzacji.