Adicionar uma fonte de dados ao Google Cloud Search

Este recurso está disponível no Cloud Search Platform. Entre em contato com o gerente de contas do Google para saber mais detalhes sobre a ativação desse recurso.

Por ser administrador, você pode configurar a pesquisa em todo o conteúdo da organização. Para pesquisar repositórios de terceiros, você precisa adicionar uma fonte de dados ao Google Cloud Search. A fonte de dados é o indexador de itens pesquisáveis em um repositório.

Antes de começar

Você (ou seu desenvolvedor) precisa ter um ID da conta de serviço com permissões de acesso à API Indexing do Cloud Search. Consulte o site para desenvolvedores do Cloud Search e veja instruções detalhadas sobre como inicializar o acesso à API.

Adicionar uma fonte de dados

Para indexar itens de um repositório de terceiros, adicione uma fonte de dados ao Cloud Search. Se você tem o Google Workspace, não precisa adicionar uma origem de dados para serviços, como o Drive e o Gmail.

  1. No Admin Console do Google, acesse Menu e depois Apps e depois Google Workspace e depois Cloud Search.

    Exige o privilégio de administrador "Configurações do serviço".

  2. Clique no card Origens de dados de terceiros.
  3. No canto superior esquerdo, clique em Adicionar .

  4. Digite um nome na linha de texto Nome de exibição. Confira os nomes que não podem ser usados em nomes reservados.

    Os usuários do Cloud Search veem esse nome nos filtros de pesquisa (na parte superior da página de resultados da pesquisa) ou na lista suspensa Mais. É recomendável incluir o tipo de origem no nome para facilitar a identificação dos usuários.

  5. Digite um nome na linha de texto Nome curto. Confira os nomes que não podem ser usados em nomes reservados.

    Para restringir os resultados da pesquisa, os usuários do Cloud Search podem usar esse nome com o operador de pesquisa de origem.

  6. Em Visibilidade, selecione uma opção:

    • Visível para todos permite que todos os membros da organização vejam os resultados dessa origem.

    • Visível para ninguém impede que todos os membros da organização vejam os resultados dessa origem.

      Se você descobrir que alguns usuários podem ver resultados que não deveriam, desative os resultados para todos até corrigir o problema.

    • Visível apenas para os seguintes usuários permite que apenas usuários ou grupos de usuários específicos da organização vejam resultados dessa origem. Digite os endereços de e-mail do grupo ou do usuário na linha de texto.

      Quando você adiciona uma fonte de dados pela primeira vez, convém desativar a visibilidade para todos, exceto alguns usuários específicos, até testar sua integração. Verifique se os usuários veem apenas os resultados da pesquisa aos quais têm acesso.

  7. Em ID da conta de serviço, adicione o endereço de e-mail da conta de serviço que autoriza a indexação dessa origem.

    Use o endereço de e-mail que foi gerado para o ID da conta de serviço quando o desenvolvedor configurar credenciais para a API Cloud Search.

  8. Não marque a caixa Ativar o modo somente leitura. Se ela estiver selecionada, o Cloud Search não iniciará a indexação do conteúdo dessa fonte de dados.

  9. Clique em Adicionar.

Depois que você adiciona a fonte de dados, ela aparece na lista de fontes de dados de terceiros. Para identificar qual delas acessar, o desenvolvedor adiciona a ID da origem à configuração do conector de conteúdo.

Próximas etapas

  1. Informe ao desenvolvedor o ID da fonte de dados que vai ser usado na configuração do conector de conteúdo.
  2. O desenvolvedor precisa criar e registrar um esquema (se o repositório de conteúdo tiver dados estruturados).
  3. Antes de ativar a visibilidade de uma origem para todos, verifique se a integração está funcionando corretamente.
  4. Mapeie identidades de usuários.

Nomes reservados

O nome de exibição ou o nome curto da sua fonte de dados não pode começar com "Google" nem usar um nome reservado.

Nomes reservados de fontes de dados

  • Agenda
  • Documentos
  • Drive
  • Gmail
  • Gplus
  • Grupos
  • Keep
  • E-mail
  • Sites

Editar ou excluir uma fonte de dados

Você controla em quais origens de dados os usuários podem pesquisar. Por exemplo, talvez você queira que a equipe de vendas pesquise em repositórios diferentes do departamento de contabilidade.

Para ocultar os resultados da pesquisa de uma fonte de dados específica, desative a visibilidade dela. Desse modo, os usuários não verão os resultados dessa fonte de dados. Isso não exclui permanentemente uma fonte de dados do Cloud Search.

Ativar ou desativar a visibilidade

Antes de começar: para ativar ou desativar a visibilidade de um grupo de usuários, coloque as contas deles em um grupo.

  1. No Admin Console do Google, acesse Menu e depois Apps e depois Google Workspace e depois Cloud Search.

    Exige o privilégio de administrador "Configurações do serviço".

  2. Clique no card Origens de dados de terceiros.
  3. Na lista, destaque a fonte de dados que você quer mudar e clique em Editar .
  4. Em Visibilidade, selecione uma opção:
    • Visível para todos permite que todos os membros da organização vejam os resultados dessa origem.
    • Visível para ninguém impede que todos os membros da organização vejam os resultados dessa origem.
    • Visível apenas para os seguintes usuários permite que apenas usuários específicos ou grupos de usuários da organização vejam resultados dessa origem. Digite os endereços de e-mail do grupo ou do usuário na linha de texto.
  5. Clique em Salvar.

Pausar a indexação de conteúdo novo

É possível impedir temporariamente a exibição de conteúdo novo nos resultados da pesquisa. Os usuários não vão ver conteúdo novo ou modificado de uma fonte se você pausar a indexação. Isso é válido para toda a organização. Não é possível pausar a indexação de unidades organizacionais individuais.

Observação:não é possível desativar a indexação de nenhum serviço do Google Workspace, como Gmail, Drive ou Grupos.

  1. No Admin Console do Google, acesse Menu e depois Apps e depois Google Workspace e depois Cloud Search.

    Exige o privilégio de administrador "Configurações do serviço".

  2. Clique no card Origens de dados de terceiros.
  3. Na lista, destaque a fonte de dados que você quer mudar e clique em Editar .
  4. Marque a caixa Ativar o modo somente leitura.
  5. Clique em Salvar.

Mudar o nome exibido nos filtros de pesquisa e no operador de pesquisa

Você pode mudar o nome que os usuários veem nos filtros de pesquisa, na parte de cima da página de resultados da pesquisa, ou na lista suspensa Mais. Também é possível mudar o nome usado pelo operador de pesquisa da origem.

  1. No Admin Console do Google, acesse Menu e depois Apps e depois Google Workspace e depois Cloud Search.

    Exige o privilégio de administrador "Configurações do serviço".

  2. Clique no card Origens de dados de terceiros.
  3. Na lista, destaque a origem que você quer mudar e clique em Editar .
  4. No campo Nome de exibição, digite um nome novo a ser exibido nos filtros de pesquisa.
  5. No campo Nome abreviado, digite uma versão curta do nome.
  6. Clique em Salvar.

Atualizar a conta de serviço

É possível mudar a conta de serviço que indexa o conteúdo dessa origem ou adicionar outra conta de serviço. Essa é a conta de serviço criada quando o desenvolvedor configurou as credenciais da API Indexing do Cloud Search.

  1. No Admin Console do Google, acesse Menu e depois Apps e depois Google Workspace e depois Cloud Search.

    Exige o privilégio de administrador "Configurações do serviço".

  2. Clique no card Origens de dados de terceiros.
  3. Na lista, destaque a origem que você quer mudar e clique em Editar .
  4. Em Endereço de e-mail da conta de serviço, digite o endereço de e-mail de uma conta de serviço autorizada.
    • Para remover um endereço de e-mail, clique em Remover ao lado dele.
  5. Clique em Salvar.

Excluir uma fonte de dados

Se a organização não precisar mais pesquisar uma fonte de dados, você poderá excluí-la permanentemente. Por exemplo, se você rescindir o contrato com um provedor de serviços, não vai mais precisar acessar a fonte de dados.

Quer impedir temporariamente que uma fonte de dados apareça nos resultados da pesquisa? Ou removê-la apenas para algumas pessoas? Não remova a origem conforme descrito aqui. Basta desativar a visibilidade dela para todas ou apenas algumas pessoas da organização.

Importante:se uma fonte de dados for excluída, todo o conteúdo indexado nela vai ser removido. Não é possível desfazer essa ação.

  1. No Admin Console do Google, acesse Menu e depois Apps e depois Google Workspace e depois Cloud Search.

    Exige o privilégio de administrador "Configurações do serviço".

  2. Clique no card Origens de dados de terceiros.
  3. Na lista, destaque a fonte de dados que você quer mudar e clique em Excluir .
  4. Clique em Salvar.

Depois que a origem de conteúdo é excluída, ela não fica disponível para indexação e pesquisa. Se você mudar de ideia depois, poderá adicionar a origem novamente e reindexar.