Method: spaces.patch

Atualiza um espaço. Veja um exemplo em Atualizar um espaço.

Se você estiver atualizando o campo displayName e receber a mensagem de erro ALREADY_EXISTS, tente outro nome de exibição. Talvez um espaço da organização do Google Workspace já use esse nome de exibição.

Requer a autenticação do usuário.

Solicitação HTTP

PATCH https://chat.googleapis.com/v1/{space.name=spaces/*}

O URL usa a sintaxe de transcodificação gRPC.

Parâmetros de caminho

Parâmetros
space.name

string

Nome do recurso do espaço.

Formato: spaces/{space}

Parâmetros de consulta

Parâmetros
updateMask

string (FieldMask format)

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

Caminhos de campo compatíveis atualmente:

  • displayName. Só é possível mudar o nome de exibição de um espaço com o tipo SPACE ou ao incluir a máscara spaceType para mudar um tipo de espaço GROUP_CHAT para SPACE. A tentativa de atualizar o nome de exibição de um espaço GROUP_CHAT ou DIRECT_MESSAGE resulta em um erro de argumento inválido. Se você receber a mensagem de erro ALREADY_EXISTS ao atualizar o displayName, tente usar outro displayName. Talvez um espaço da organização do Google Workspace já use esse nome de exibição.)

  • spaceType. Compatível apenas com a 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 será opcional se o espaço atual já tiver o tipo SPACE. Tentar atualizar o tipo de espaço de outras maneiras resulta em um erro de argumento inválido.

  • spaceDetails

  • spaceHistoryState Permite ativar ou desativar o histórico do espaço se a organização permitir que os usuários alterem a configuração do histórico. Aviso: mutuamente exclusivo com todos os outros caminhos de campo.)

  • Prévia para desenvolvedores: accessSettings.audience (é possível mudar a configuração de acesso de um espaço. Se nenhum público for especificado na configuração de acesso, a configuração de acesso do espaço vai ser atualizada como "Restrito". Aviso: mutuamente exclusivo com todos os outros caminhos de campo.)

Corpo da solicitação

O corpo da solicitação contém uma instância de Space.

Corpo da resposta

Se a solicitação for bem-sucedida, o corpo da resposta conterá uma instância de Space.

Escopos de autorização

Requer um dos seguintes escopos de OAuth:

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

Para mais informações, consulte o Guia de autorização.