Method: spaces.patch

Aktualizuje pokój. Przykład znajdziesz w artykule Aktualizowanie pokoju.

Jeśli aktualizujesz pole displayName i wyświetla się komunikat o błędzie ALREADY_EXISTS, użyj innej wyświetlanej nazwy. Obecna przestrzeń w organizacji Google Workspace może już mieć tę wyświetlaną nazwę.

Wymaga uwierzytelniania użytkownika.

Żądanie HTTP

PATCH https://chat.googleapis.com/v1/{space.name=spaces/*}

Adres URL używa składni transkodowania gRPC.

Parametry ścieżki

Parametry
space.name

string

Nazwa zasobu pokoju.

Format: spaces/{space}

Parametry zapytania

Parametry
updateMask

string (FieldMask format)

Wymagany. Zaktualizowane ścieżki pól rozdzielone przecinkami, jeśli jest ich więcej.

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

  • displayName (obsługuje tylko wyświetlaną nazwę pokoju z typem SPACE) lub masę spaceType, aby zmienić typ pokoju GROUP_CHAT na SPACE. Jeśli spróbujesz zmienić wyświetlaną nazwę pokoju GROUP_CHAT lub DIRECT_MESSAGE, wystąpi błąd nieprawidłowego argumentu. Jeśli podczas aktualizowania karty displayName pojawi się komunikat o błędzie ALREADY_EXISTS, wypróbuj inny displayName. Obecna przestrzeń w organizacji Google Workspace może już zawierać tę wyświetlaną nazwę).

  • spaceType (można tylko zmienić typ pokoju GROUP_CHAT na SPACE. Uwzględnij displayName razem z spaceType w masce aktualizacji i upewnij się, że podana przestrzeń nie ma pustej nazwy wyświetlanej ani typu pokoju SPACE. Uwzględnienie maski spaceType i typu SPACE w określonym pokoju podczas aktualizowania wyświetlanej nazwy jest opcjonalne, jeśli istniejący pokój ma już typ SPACE. Próba zaktualizowania typu pokoju w inny sposób powoduje błąd nieprawidłowego argumentu).

  • spaceDetails

  • spaceHistoryState (obsługuje włączanie i wyłączanie historii w pokoju), jeśli organizacja zezwala użytkownikom na zmienianie ustawień historii. Ostrzeżenie: wzajemnie wykluczające się wszystkie pozostałe ścieżki.

Treść żądania

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

Treść odpowiedzi

W przypadku powodzenia treść odpowiedzi obejmuje wystąpienie elementu Space.

Zakresy autoryzacji

Wymaga jednego z tych zakresów OAuth:

  • https://www.googleapis.com/auth/chat.import
  • https://www.googleapis.com/auth/chat.spaces

Więcej informacji znajdziesz w przewodniku po autoryzacji.