Jeśli aktualizujesz pole displayName i pojawi 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.
https://www.googleapis.com/auth/chat.import (tylko pokoje w trybie importowania)
Uwierzytelnianie użytkownika przyznaje uprawnienia administratora, gdy uwierzytelnione jest konto administratora, useAdminAccess jest true i używane są te zakresy autoryzacji:
https://www.googleapis.com/auth/chat.admin.spaces
Uwierzytelnianie aplikacji ma te ograniczenia:
Aby zaktualizować space.predefined_permission_settings lub space.permission_settings, aplikacja musi być twórcą pokoju.
Aktualizacja space.access_settings.audience nie jest obsługiwana w przypadku uwierzytelniania aplikacji.
gdzie {space} to identyfikator pokoju przypisany przez system. Identyfikator pokoju możesz uzyskać, wywołując metodę spaces.list() lub z adresu URL pokoju. Jeśli na przykład adres URL pokoju to https://mail.google.com/mail/u/0/#chat/space/AAAAAAAAA, identyfikator pokoju to AAAAAAAAA.
Wymagany. Zaktualizowane ścieżki pól, rozdzielone przecinkami, jeśli jest ich kilka.
W przypadku pokoju możesz zaktualizować te pola:
spaceDetails: aktualizuje opis pokoju. Może zawierać maksymalnie 150 znaków.
displayName: obsługuje tylko aktualizowanie nazwy wyświetlanej 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: obsługuje tylko zmianę typu pokoju z GROUP_CHAT na SPACE. W masce aktualizacji uwzględnij displayName wraz z spaceType i upewnij się, że określona przestrzeń ma niepustą wyświetlaną nazwę i typ przestrzeni SPACE. Podczas aktualizowania wyświetlanej nazwy uwzględnienie maski spaceType i typu SPACE w określonej przestrzeni jest opcjonalne, jeśli istniejąca przestrzeń ma już typ SPACE. Próba zmiany typu pokoju w inny sposób spowoduje błąd nieprawidłowego argumentu. spaceType nie jest obsługiwane w przypadku useAdminAccess.
spaceHistoryState: aktualizuje ustawienia historii pokoju, włączając lub wyłączając historię pokoju. Ta opcja jest obsługiwana tylko wtedy, gdy w organizacji Google Workspace włączone są ustawienia historii. Aby zaktualizować stan historii pokoju, musisz pominąć w żądaniu wszystkie inne maski pól. spaceHistoryState nie jest obsługiwane w przypadku useAdminAccess.
accessSettings.audience: aktualizuje ustawienie dostępu określające, kto może odkrywać pokój, dołączać do niego i wyświetlać podgląd wiadomości w pokoju nazwanym, w którym pole spaceType ma wartość SPACE. Jeśli istniejący pokój ma grupę odbiorców, możesz ją usunąć i ograniczyć dostęp do pokoju, pomijając wartość w tej masce pola. Aby zaktualizować ustawienia dostępu do pokoju, uwierzytelniony użytkownik musi być menedżerem pokoju i pominąć wszystkie inne maski pól w żądaniu. Nie możesz zaktualizować tego pola, jeśli pokój jest w trybie importowania. Więcej informacji znajdziesz w artykule Udostępnianie pokoju konkretnym użytkownikom. accessSettings.audience nie jest obsługiwane w przypadku useAdminAccess.
permissionSettings: umożliwia zmianę ustawień uprawnień pokoju. Podczas aktualizowania ustawień uprawnień możesz określić tylko maski pól permissionSettings. Nie możesz jednocześnie aktualizować innych masek pól. permissionSettings nie jest obsługiwane w przypadku useAdminAccess. Obsługiwane maski pól to:
permissionSettings.manageMembersAndGroups
permissionSettings.modifySpaceDetails
permissionSettings.toggleHistory
permissionSettings.useAtMentionAll
permissionSettings.manageApps
permissionSettings.manageWebhooks
permissionSettings.replyMessages
useAdminAccess
boolean
Opcjonalnie. Gdy true, metoda jest wykonywana z użyciem uprawnień administratora Google Workspace użytkownika.
[[["Łatwo zrozumieć","easyToUnderstand","thumb-up"],["Rozwiązało to mój problem","solvedMyProblem","thumb-up"],["Inne","otherUp","thumb-up"]],[["Brak potrzebnych mi informacji","missingTheInformationINeed","thumb-down"],["Zbyt skomplikowane / zbyt wiele czynności do wykonania","tooComplicatedTooManySteps","thumb-down"],["Nieaktualne treści","outOfDate","thumb-down"],["Problem z tłumaczeniem","translationIssue","thumb-down"],["Problem z przykładami/kodem","samplesCodeIssue","thumb-down"],["Inne","otherDown","thumb-down"]],["Ostatnia aktualizacja: 2025-07-29 UTC."],[[["\u003cp\u003eUpdates a Google Chat space's details, including display name, description, space type, history settings, access settings, and permission settings.\u003c/p\u003e\n"],["\u003cp\u003eRequires specific authentication and authorization, including app authentication with administrator approval or user authentication, potentially with administrator privileges.\u003c/p\u003e\n"],["\u003cp\u003eSupports partial updates using the \u003ccode\u003eupdateMask\u003c/code\u003e query parameter to specify the fields to be modified.\u003c/p\u003e\n"],["\u003cp\u003eProvides options for using administrator privileges with the \u003ccode\u003euseAdminAccess\u003c/code\u003e query parameter, but some fields and functionalities are not supported in this mode.\u003c/p\u003e\n"],["\u003cp\u003eUses the PATCH HTTP method and gRPC Transcoding syntax for the request URL.\u003c/p\u003e\n"]]],["This content describes how to update a space within Google Workspace Chat via the API. Key actions include sending a `PATCH` request to `https://chat.googleapis.com/v1/{space.name=spaces/*}`, specifying the space's name in the path. The `updateMask` query parameter defines which fields to update, including space details, display name, type, history state, access and permissions. `useAdminAccess` allow to update the space with administrator permissions. Authentication requires specific OAuth scopes. The request and response body use the `Space` object.\n"],null,[]]
