Ativar miniaturas

As miniaturas ajudam os usuários a identificar resultados de pesquisa relevantes. Elas têm estas características:

• Largura de 1024 px.
• Os URLs das miniaturas de arquivos do Google Workspace são protegidos por ACL. Outros tipos de arquivo não são.
• Os URLs expiram após 5 minutos.
• O tamanho máximo do arquivo para geração é de 50 MB.
• Se a geração falhar, o Cloud Search vai retornar um ícone de marcador. Para itens do Google Workspace, o URL retorna "404 Não encontrado". Seu aplicativo precisa processar isso.

O Google Drive cria miniaturas automaticamente para tipos compatíveis, como Documentos, Planilhas e Apresentações. O Cloud Search também gera miniaturas para:

• Microsoft Word (DOC, DOCX)
• Microsoft Excel (XLS, XLSX)
• Microsoft PowerPoint (PPT, PPTX)
• Adobe PDF
• RTF, TXT, HTML e XML

O Cloud Search só retorna miniaturas de itens quando você as ativa para a fonte de dados e o app de pesquisa.

Ativar URLs de miniaturas para uma origem de dados

Para ativar URLs de miniaturas, crie uma chave de API e credenciais de aplicativo da Web. Use-as para receber um token de acesso e atualizar sua origem de dados.

1. Crie ou selecione um projeto e ative a API. Consulte Configurar o acesso à API Cloud Search.
2. Crie uma chave de API no console do Google Cloud e anote o valor.
3. Crie credenciais de aplicativo da Web. Use https://developers.google.com/oauthplayground como o URI de redirecionamento. Consulte Criar credenciais.
4. No OAuth 2.0 Playground, abra as configurações de Configuração do OAuth 2.0 .
5. Selecione Usar suas próprias credenciais e insira o ID do cliente e a chave secreta.
6. Insira https://www.googleapis.com/auth/cloud_search.settings no campo de escopos e clique em Autorizar APIs.
7. Troque o código de autorização por tokens.

8. Chame settings.datasources.get para receber o ID da origem de dados:

   curl 'https://cloudsearch.googleapis.com/v1/settings/DATASOURCE_ID?key=YOUR_API_KEY' \
   --header 'Authorization: Bearer YOUR_ACCESS_TOKEN' \
   --header 'Accept: application/json' \
   --compressed
   

9. Chame settings.datasources.update com returnThumbnailUrls definido como true:

   curl --request PUT \
   'https://cloudsearch.googleapis.com/v1/settings/datasources/DATASOURCE_ID?key=YOUR_API_KEY' \
   --header 'Authorization: Bearer YOUR_ACCESS_TOKEN' \
   --header 'Accept: application/json' \
   --header 'Content-Type: application/json' \
   --data '{"source":{"name":"datasources/DATASOURCE_ID","displayName":"DISPLAY_NAME","itemsVisibility":[{"gsuiteDomain":true}],"returnThumbnailUrls":true}}' \
   --compressed
   

Ativar URLs de miniaturas para um app de pesquisa

Você também precisa ativar as miniaturas no app de pesquisa.

1. Receba uma chave de API e um token de acesso usando o mesmo método descrito em na seção anterior.

2. Chame settings.searchapplications.get para receber o ID do aplicativo:

   curl 'https://cloudsearch.googleapis.com/v1/settings/searchapplications/APP_ID?key=YOUR_API_KEY' \
   --header 'Authorization: Bearer YOUR_ACCESS_TOKEN' \
   --header 'Accept: application/json' \
   --compressed
   

3. Chame settings.searchapplications.update com returnResultThumbnailUrls definido como true:

   curl --request PUT \
   'https://cloudsearch.googleapis.com/v1/settings/searchapplications/APP_ID?key=YOUR_API_KEY' \
   --header 'Authorization: Bearer YOUR_ACCESS_TOKEN' \
   --header 'Accept: application/json' \
   --header 'Content-Type: application/json' \
   --data '{"name":"searchapplications/APP_ID","displayName":"DISPLAY_NAME","dataSourceRestrictions":[{"source":{"name":"datasources/DATASOURCE_ID"}}],"returnResultThumbnailUrls":true}' \
   --compressed
   

Acessar miniaturas

Para acessar uma miniatura de um arquivo do Drive, o usuário ou aplicativo precisa usar as mesmas credenciais de conta usadas para acessar o item original.