Method: spaces.patch

Aktualizuje pokój. Przykład znajduje się w artykule Aktualizowanie pokoju.

Jeśli aktualizujesz pole displayName i pojawia się komunikat o błędzie ALREADY_EXISTS, spróbuj użyć innej wyświetlanej nazwy. Ta wyświetlana nazwa może już być używana w istniejącym pokoju w organizacji Google Workspace.

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)

To pole jest wymagane. Zaktualizowane ścieżki pól rozdzielone przecinkami, jeśli występują kilka ścieżek.

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

  • displayName (obsługuje tylko zmianę wyświetlanej nazwy pokoju o typie SPACE lub dodanie maski spaceType w celu zmiany typu pokoju GROUP_CHAT na SPACE). Próba zaktualizowania wyświetlanej nazwy pokoju GROUP_CHAT lub DIRECT_MESSAGE powoduje wystąpienie błędu argumentu. Jeśli podczas aktualizowania urządzenia displayName pojawi się komunikat o błędzie ALREADY_EXISTS, spróbuj użyć innej metody displayName. Istnieje już pokój w organizacji Google Workspace, który może już używać tej wyświetlanej nazwy).

  • spaceType (obsługuje tylko zmianę typu pokoju GROUP_CHAT na SPACE. W masce aktualizacji dodaj pole displayName wraz z atrybutem spaceType i upewnij się, że w wybranym miejscu wyświetlana jest nazwa, która nie jest pusta, oraz że typ spacji SPACE. Podanie maski spaceType i typu SPACE w określonym miejscu podczas aktualizowania wyświetlanej nazwy jest opcjonalne, jeśli istniejący pokój ma już typ SPACE. Jeśli spróbujesz zaktualizować typ pokoju w inny sposób, wystąpi błąd nieprawidłowego argumentu).

  • spaceDetails

  • spaceHistoryState (obsługuje włączanie i wyłączanie historii w pokoju, jeśli organizacja zezwala użytkownikom na zmianę ustawień historii); Ostrzeżenie: wzajemnie się wykluczają ze wszystkimi innymi ścieżkami pól).

  • Wersja przedpremierowa dla programistów: accessSettings.audience (obsługuje zmianę ustawienia dostępu pokoju). Jeśli w ustawieniu dostępu nie określisz żadnej grupy odbiorców, dostęp do pokoju zostanie zmieniony na ograniczony. Ostrzeżenie: wzajemnie się wykluczają ze wszystkimi innymi ścieżkami pól).

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.