Se você estiver atualizando o campo displayName e receber a mensagem de erro ALREADY_EXISTS, tente outro nome de exibição. Um espaço na organização do Google Workspace já pode estar usando esse nome de exibição.
Oferece suporte aos seguintes tipos de autenticação:
https://www.googleapis.com/auth/chat.import (somente espaços no modo de importação)
A autenticação do usuário concede privilégios de administrador quando uma conta de administrador é autenticada, useAdminAccess é true e os seguintes escopos de autorização são usados:
https://www.googleapis.com/auth/chat.admin.spaces
A autenticação de apps tem as seguintes limitações:
Para atualizar space.predefined_permission_settings ou space.permission_settings, o app precisa ser o criador do espaço.
A atualização de space.access_settings.audience não é compatível com a autenticação de apps.
Em que {space} representa o ID atribuído pelo sistema ao espaço. Você pode receber o ID do espaço chamando o spaces.list() método ou no URL do espaço. Por exemplo, se o URL do espaço for https://mail.google.com/mail/u/0/#chat/space/AAAAAAAAA, o ID do espaço será AAAAAAAAA.
Obrigatório. Os caminhos de campo atualizados, separados por vírgula se houver vários.
É possível atualizar os seguintes campos de um espaço:
spaceDetails: atualiza a descrição e as diretrizes do espaço. É necessário transmitir a descrição e as diretrizes na solicitação de atualização como SpaceDetails. Se você quiser atualizar apenas um dos campos, transmita o valor atual do outro campo.
displayName: só oferece suporte à atualização do nome de exibição para espaços em que o campo spaceType é SPACE. Se você receber a mensagem de erro ALREADY_EXISTS, tente um valor diferente. Um espaço na organização do Google Workspace já pode estar usando esse nome de exibição.
spaceType: só oferece suporte à mudança de um tipo de espaço GROUP_CHAT para SPACE. Inclua displayName com spaceType na máscara de atualização e verifique se o espaço especificado tem um nome de exibição não vazio e o tipo de espaço SPACE. Incluir a máscara spaceType e o tipo SPACE no espaço especificado ao atualizar o nome de exibição é opcional se o espaço já tiver o tipo SPACE. Tentar atualizar o tipo de espaço de outras maneiras resulta em um erro de argumento inválido. spaceType não é compatível com useAdminAccess.
spaceHistoryState: atualiza as configurações de histórico do espaço ativando ou desativando o histórico do espaço. Só é compatível se as configurações de histórico estiverem ativadas para a organização do Google Workspace. Para atualizar o estado do histórico do espaço, omita todas as outras máscaras de campo na solicitação. spaceHistoryState não é compatível com useAdminAccess.
accessSettings.audience: atualiza a configuração de acesso de quem pode descobrir o espaço, participar dele e visualizar as mensagens no espaço nomeado em que o campo spaceType é SPACE. Se o espaço tiver um público-alvo, você poderá remover o público e restringir o acesso ao espaço omitindo um valor para essa máscara de campo. Para atualizar as configurações de acesso de um espaço, o usuário autenticado precisa ser um administrador do espaço e omitir todas as outras máscaras de campo na solicitação. Não é possível atualizar esse campo se o espaço estiver no modo de importação. Para saber mais, consulte Tornar um espaço detectável para usuários específicos. accessSettings.audience não é compatível com useAdminAccess.
accessSettings.access_permission_settings: atualiza as configurações de permissão de acesso de quem pode descobrir e participar do espaço em que o campo spaceType é SPACE. Os principais permitidos a participar do espaço também precisam ter permissão para descobri-lo. Para atualizar as configurações de permissão de acesso de um espaço, o usuário autenticado precisa ser um administrador ou administrador assistente do espaço e omitir todas as outras máscaras de campo na solicitação. Não é possível atualizar esse campo se o espaço estiver no modo de importação. Para saber mais, consulte Tornar um espaço detectável para usuários específicos. accessSettings.access_permission_settings não é compatível com useAdminAccess. As máscaras de campo compatíveis incluem:
permissionSettings: oferece suporte à mudança das configurações de permissão de um espaço. Ao atualizar as configurações de permissão, só é possível especificar máscaras de campo permissionSettings. Não é possível atualizar outras máscaras de campo ao mesmo tempo. As máscaras de campo compatíveis incluem:
permissionSettings.manageMembersAndGroups
permissionSettings.modifySpaceDetails
permissionSettings.toggleHistory
permissionSettings.useAtMentionAll
permissionSettings.manageApps
permissionSettings.manageWebhooks
permissionSettings.replyMessages
useAdminAccess
boolean
Opcional. Quando true, o método é executado usando os privilégios de administrador do Google Workspace do usuário.
[[["Fácil de entender","easyToUnderstand","thumb-up"],["Meu problema foi resolvido","solvedMyProblem","thumb-up"],["Outro","otherUp","thumb-up"]],[["Não contém as informações de que eu preciso","missingTheInformationINeed","thumb-down"],["Muito complicado / etapas demais","tooComplicatedTooManySteps","thumb-down"],["Desatualizado","outOfDate","thumb-down"],["Problema na tradução","translationIssue","thumb-down"],["Problema com as amostras / o código","samplesCodeIssue","thumb-down"],["Outro","otherDown","thumb-down"]],["Última atualização 2026-07-09 UTC."],[],["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"]]
