Method: spaces.patch

string

Identificador. Nome do recurso do espaço.

Formato: spaces/{space}

em que {space} representa o ID atribuído pelo sistema ao espaço. Você pode conseguir o ID do espaço chamando o método spaces.list() ou pelo 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.

string (FieldMask format)

Obrigatório. Os caminhos de campo atualizados, separados por vírgulas se houver vários.

Você pode atualizar os seguintes campos de um espaço:

spaceDetails: atualiza a descrição do espaço. Aceita até 150 caracteres.

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 existente na organização do Google Workspace já pode usar esse nome de exibição.

spaceType: só oferece suporte à mudança de um tipo de espaço GROUP_CHAT para SPACE. Inclua displayName e 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. A inclusão da máscara spaceType e do tipo SPACE no espaço especificado ao atualizar o nome de exibição é opcional se o espaço atual já tiver o tipo SPACE. A tentativa de 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 do histórico do espaço ativando ou desativando o histórico do espaço. Disponível apenas se as configurações de histórico estiverem ativadas na organização do Google Workspace. Para atualizar o estado do histórico do espaço, omita todas as outras máscaras de campo da solicitação. spaceHistoryState não é compatível com useAdminAccess.

accessSettings.audience: atualiza a configuração de acesso de quem pode descobrir, participar 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-alvo 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 autenticador precisa ser um administrador e omitir todas as outras máscaras de campo da solicitação. Não é possível atualizar esse campo se o espaço estiver no modo de importação. Saiba mais em Tornar um espaço detectável para usuários específicos. accessSettings.audience não é compatível com useAdminAccess.

permissionSettings: permite mudar as 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. permissionSettings não é compatível com useAdminAccess. As máscaras de campo compatíveis incluem:

• permissionSettings.manageMembersAndGroups
• permissionSettings.modifySpaceDetails
• permissionSettings.toggleHistory
• permissionSettings.useAtMentionAll
• permissionSettings.manageApps
• permissionSettings.manageWebhooks
• permissionSettings.replyMessages

boolean

Opcional. Quando true, o método é executado usando os privilégios de administrador do Google Workspace do usuário.

O usuário que faz a chamada precisa ser um administrador do Google Workspace com o privilégio "Gerenciar conversas de chats e espaços".

Exige o escopo OAuth 2.0 chat.admin.spaces.

Alguns valores de FieldMask não são aceitos com acesso de administrador. Para mais detalhes, consulte a descrição de updateMask.