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.

Możesz zaktualizować te pola pokoju:

  • spaceDetails

  • displayName: obsługuje aktualizowanie wyświetlanej nazwy tylko w przypadku pokoi, w których pole spaceType ma wartość SPACE. Jeśli pojawi się komunikat o błędzie ALREADY_EXISTS, spróbuj użyć innej wartości. Istniejący pokój w organizacji Google Workspace może już używać tej wyświetlanej nazwy.

  • spaceType: umożliwia zmianę tylko typu 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.

  • spaceHistoryState: zmienia ustawienia historii pokoju przez włączenie lub wyłączenie historii w pokoju. Obsługiwane tylko wtedy, gdy w organizacji Google Workspace są włączone ustawienia historii. Aby zaktualizować stan historii pokoju, musisz pominąć w żądaniu wszystkie inne maski pól. Usługa spaceHistoryState nie jest obsługiwana z dostępem administracyjnym.

  • accessSettings.audience: aktualizuje ustawienie dostępu określające, kto może odkrywać pokój, dołączać do pokoju i wyświetlać podgląd wiadomości w nazwanym pokoju, w którym pole spaceType ma wartość SPACE. Jeśli w istniejącym pokoju znajduje się grupa odbiorców, możesz ją usunąć i ograniczyć dostęp do pokoju, pomijając wartość tej maski pola. Aby zaktualizować ustawienia dostępu do pokoju, użytkownik uwierzytelniający musi być menedżerem pokoju i pominąć wszystkie inne maski pól w Twojej prośbie. Nie możesz zaktualizować tego pola, jeśli pokój jest w trybie importowania. Więcej informacji znajdziesz w artykule Ustawianie pokoju jako wykrywalnego dla określonych użytkowników. 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.