Method: spaces.patch

Aktualizuje pokój. Przykład znajdziesz 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. Istniejący pokój w organizacji Google Workspace może już używać tej wyświetlanej nazwy.

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)

Wymagane. Zaktualizowane ścieżki pól, jeśli jest ich kilka, rozdziel je przecinkami.

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

  • displayName (obsługuje tylko zmienianie wyświetlanej nazwy pokoju o typie SPACE lub uwzględnianie maski spaceType w celu zmiany typu pokoju GROUP_CHAT na SPACE. Próba zaktualizowania wyświetlanej nazwy pokoju GROUP_CHAT lub DIRECT_MESSAGE powoduje wyświetlenie błędu dotyczącego nieprawidłowego argumentu. Jeśli podczas aktualizowania elementu displayName pojawi się komunikat o błędzie ALREADY_EXISTS, spróbuj użyć innego urządzenia displayName. Istniejący pokój w organizacji Google Workspace może już używać tej wyświetlanej nazwy.

  • spaceType (można zmienić tylko typ pokoju GROUP_CHAT na SPACE. Uwzględnij w masce aktualizacji parametr displayName razem z atrybutem spaceType i upewnij się, że wskazane miejsce ma niepustą wyświetlaną nazwę i typ pokoju SPACE. Podczas aktualizowania wyświetlanej nazwy uwzględnienie maski spaceType i typu SPACE w określonym obszarze jest opcjonalne, jeśli istniejący pokój ma już typ SPACE. Próba zaktualizowania typu pokoju w inny sposób skutkuje błędem nieprawidłowego argumentu. Usługa spaceType nie jest obsługiwana z dostępem administracyjnym.

  • spaceDetails

  • spaceHistoryState (obsługuje włączanie i wyłączanie historii pokoju, jeśli organizacja zezwala użytkownikom na zmienianie ustawień historii. Ostrzeżenie: wzajemnie się wyklucza ze wszystkimi innymi ścieżkami pól). Usługa spaceHistoryState nie jest obsługiwana z dostępem administracyjnym.

  • Podgląd dla programistów: accessSettings.audience (pozwala zmieniać ustawienie dostępu do pokoju. Jeśli w ustawieniu dostępu nie określisz żadnej grupy odbiorców, poziom dostępu do pokoju zostanie zmieniony na „Ograniczony”. Ostrzeżenie: wzajemnie się wyklucza ze wszystkimi innymi ścieżkami pól). Usługa accessSettings.audience nie jest obsługiwana z dostępem administracyjnym.

  • Wersja przedpremierowa dla programistów: umożliwia zmianę ustawień uprawnień pokoju. Obsługiwane ścieżki pól to między innymi: permissionSettings.manage_members_and_groups, permissionSettings.modify_space_details, permissionSettings.toggle_history, permissionSettings.use_at_mention_all, permissionSettings.manage_apps, permissionSettings.manage_webhooks, permissionSettings.reply_messages (ostrzeżenie: wzajemnie wyklucza się ze wszystkimi pozostałymi ścieżkami pól niezawierającymi uprawnień). Usługa permissionSettings nie jest obsługiwana z dostępem administracyjnym.
useAdminAccess

boolean

Jeśli zasada jest true, metoda jest uruchamiana z uprawnieniami administratora Google Workspace użytkownika.

Użytkownik dzwoniący musi być administratorem Google Workspace z uprawnieniami do zarządzania czatem i rozmowami w pokoju.

Wymaga chat.admin.spaces zakresu OAuth 2.0.

Niektóre wartości FieldMask nie są obsługiwane w przypadku dostępu administracyjnego. Aby dowiedzieć się więcej, przeczytaj opis usługi updateMask.

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 protokołu OAuth:

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

Więcej informacji znajdziesz w przewodniku na temat autoryzacji.