O Object Enrichments, em prévia no Cloud Storage, processa imagens e PDFs elegíveis de forma assíncrona: os modelos geram metadados estruturados, que ficam associados ao objeto como object context. O recurso pode ser acessado pelo console ou pela API, e os resultados também podem seguir para análise no BigQuery por meio de conjuntos de dados do Storage Insights. Visão geral oficial do Object Enrichments · Anúncio do Google Cloud
Antes de configurar o processamento, escolha o modelo pela tarefa necessária e confira se o arquivo e o bucket atendem aos requisitos.
Cinco modelos para tarefas diferentes
A prévia lista cinco modelos. Cada um atende a uma tarefa específica e produz um tipo de resultado diferente, conforme a documentação do Google Cloud.
| Modelo | Resultado documentado |
| Object detection | Identifica objetos e registra suas posições com limites retangulares. |
| Image labeling | Atribui rótulos a categorias da imagem. |
| Face detection | Pode retornar polígonos delimitadores, marcos faciais, ângulos de orientação e probabilidades de expressões. |
| Explicit content detection | Retorna classificações de probabilidade para conteúdo adulto ou violento. |
| PDF classification | Atribui categorias a documentos PDF. |
A distinção ajuda a direcionar cada arquivo à tarefa apropriada: detectar objetos, por exemplo, gera posições delimitadas; classificar um PDF produz categorias de documento. Os resultados são metadados associados ao arquivo, não uma substituição do conteúdo original.
Onde ficam os resultados
O Cloud Storage anexa os resultados ao objeto em um contexto personalizado. O Google descreve controles de IAM para gerenciar o acesso a esses dados e indica o caminho do Storage Insights para exportá-los a conjuntos de dados e analisá-los no BigQuery. O contexto JSON de cada objeto pode ter até 128 KiB, segundo o anúncio do Google Cloud.
Como o processamento é assíncrono, a análise não precisa acontecer no mesmo momento em que o arquivo é armazenado. Depois, os metadados podem servir de base para consultas e análises sobre os objetos.
Requisitos para arquivos e buckets
Imagens e PDFs precisam ter até 20 MiB e um cabeçalho Content-Type válido e compatível. Os formatos de imagem listados são BMP, GIF, ICO, JPEG, PNG, TIFF e WEBP; para documentos, o tipo aceito é PDF (application/pdf). A documentação também lista três grupos de locais de processamento: us, eu e asia. Configurar o mesmo bucket e modelo em mais de um local repete o processamento e gera uma cobrança por execução. Requisitos oficiais
Buckets Rapid e buckets com namespace hierárquico ativado não são compatíveis; objetos criptografados com chaves fornecidas pelo cliente também ficam fora do suporte. As configurações usam nomes exatos de buckets, sem curingas ou expressões regulares. A movimentação de um bucket é incompatível com o recurso, e buckets criados ou recriados depois da configuração não são adicionados automaticamente a ela. Se o inventário de buckets mudar, a configuração precisa levar essa mudança em conta.
Gemini nativo ainda não faz parte da prévia
O anúncio do Google Cloud descreve o enriquecimento nativo com Gemini como uma funcionalidade futura, fora do escopo da prévia atual. O recurso em prévia se concentra nos cinco modelos listados para imagens e PDFs elegíveis.