Acessar arquivos da leitura de entidades

Em 31 de outubro de 2024, os arquivos da leitura de entidades vão ser desativados e não será mais gerado. Para mais detalhes, consulte nosso guia de migração para o Rede de Display e API Video 360.

Os arquivos da leitura de entidades são representações JSON dos objetos de campanha de um parceiro. Arquivos da leitura de entidades são somente leitura e não podem ser usados para gravar alterações no Display & Vídeo em 360°. Para saber mais sobre como usar Arquivos da leitura de entidades, entre em contato com seu gerente de contas, que poderá discutir suas necessidades em mais detalhes.

Os arquivos da leitura de entidades ficam disponíveis por apenas 60 dias a partir da data de processamento.

O formato dos arquivos da leitura de entidades pode ser visualizado na Referência de formato do arquivo.

Os arquivos de leitura de entidade são armazenados como dois grupos:

• tabelas públicas, que contêm dados públicos comuns, como informações sobre versões do navegador ou linguagens armazenadas no bucket gdbm-public.
• Tabelas particulares, que contêm informações sobre campanhas, orçamentos e outros dados do parceiro dados privados. As tabelas privadas são armazenadas em buckets específicos do parceiro. por exemplo, se sua ID do parceiro for 123, o bucket que continha suas tabelas privadas será gdbm-123.

. Tanto as tabelas públicas quanto as privadas estão em um subdiretório entity dentro do bucket. Para obter mais informações sobre como tratar subdiretórios, consulte Namespace de objeto do Cloud Storage.
As tabelas públicas são geradas às 5h UTC. As tabelas privadas são geradas às 5h no fuso horário do seu parceiro (embora em raros casos possam haver atrasos) e armazenadas de forma automática e com segurança no Google Cloud Storage. Um arquivo de resumo é gerado após todas as tabelas públicas e privadas foram geradas.

Todos os nomes de arquivo diferenciam maiúsculas de minúsculas.

Tabelas públicas

gdbm-public/entity/(processing_date).(batch_index).(entity_type).json

Campo	Descrição
processing_date	A data em que os eventos O Video 360 processou os dados e não está necessariamente relacionado aos eventos contidos no arquivo. O formato da data é YYYYMMDD, por exemplo, 20120320 seria 20 de março de 2012.
batch_index	Um índice do lote baseado em zero. Por exemplo, se for gerado a cada hora, o primeiro lote seria 0, o segundo lote seria 1 e assim por diante.
entity_type	O tipo de arquivo: SupportedExchange, DataPartner, UniversalSite GeoLocation, Language, OperatingSystem, Browser, Isp, summary e SiteIdToPlacementId.csv.

Por exemplo, se você estivesse gerando um nome de arquivo para recuperar o arquivo da leitura de entidades da tabela browser de 15 de janeiro de 2013, o caminho para o arquivo seria semelhante a

gdbm-public/entity/20130115.0.Browser.json

Tabelas privadas

gdbm-(partner_id)/entity/(processing_date).(batch_index).(entity_type).json

Campo	Descrição
partner_id	É o ID numérico do parceiro.
processing_date	A data em que os eventos O Video 360 processou os dados. Essa data não está necessariamente relacionada aos eventos contidos no arquivo. O formato da data é YYYYMMDD. Por exemplo, 20120320 seria 20 de março de 2012. Os arquivos serão gerados entre 4h e 6h no fuso horário do parceiro.
batch_index	Um índice do lote baseado em zero. Atualmente, esse valor é sempre 0.
entity_type	O tipo de arquivo: Partner, Advertiser, InsertionOrder, LineItem, Creative, Pixel, InventorySource, UserList, UniversalChannel e summary.

Por exemplo, se você gerar um nome de arquivo para recuperar o arquivo de leitura de entidade do parceiro 123 acessando a tabela line_item de 2 de abril de 2013, o nome do arquivo será parecido com este:

gdbm-123/entity/20130402.0.LineItem.json