访问实体读取文件

实体读取文件是合作伙伴的广告系列对象的 JSON 表示。实体读取文件是只读的，不能用于将更改回写到 Google Display & Video 360。如需详细了解如何使用实体读取文件，请与您的客户经理联系，他们可以更详细地讨论您的需求。

请注意，实体读取文件只能在处理日期后的 60 天内使用。

可以在文件格式参考文档中查看实体读取文件的格式。

实体读取文件存储为两组：

  • 公开表，包含常用的公开数据，例如存储在 gdbm-public 存储分区中的浏览器版本或语言的相关信息。
  • 私有表，其中包含合作伙伴的广告系列、预算和其他私有数据的相关信息。专用表存储在合作伙伴专用存储分区中；例如，如果您的合作伙伴 ID 为 123，则包含您的不公开表的存储分区将为 gdbm-123。
公开表和私有表均位于存储分区内的 entity 子目录中。 如需详细了解如何处理子目录，请参阅 Cloud Storage 对象命名空间。
公开表的生成时间是世界协调时间 (UTC) 早上 5 点。专用表的生成时间是合作伙伴所在时区的早上 5 点（尽管在极少数情况下，可能会延迟），并自动安全地存储在 Google Cloud Storage 中。生成所有公开表和不公开表后，系统会生成摘要文件。

公共表

gdbm-public/entity/(processing_date).(batch_index).(entity_type).json
字段说明
processing_dateDisplay & Video 360 处理数据的日期，不一定与文件中包含的事件相关。日期格式为 YYYYMMDD，例如，20120320 为 2012 年 3 月 20 日。
batch_index 批次的索引（从零开始）。例如，如果每小时生成一次，第一个批次将为 0，第二个批次将为 1，依此类推。
entity_type文件类型：SupportedExchange、DataPartner、UniversalSite、GeoLocation、Language、OperatingSystem、Browser、Isp、summary 和 SiteIdToPlacementId.csv。
例如，如果您要生成一个文件名来检索 2013 年 1 月 15 日以后 browser 表的实体读取文件，则该文件的路径将如下所示： 
gdbm-public/entity/20130115.0.Browser.json

私密表

gdbm-(partner_id)/entity/(processing_date).(batch_index).(entity_type).json
字段说明
partner_id您的合作伙伴的数字 ID。
processing_dateDisplay & Video 360 处理数据的日期。此日期不一定与文件中的活动相关。日期格式为 YYYYMMDD，例如，20120320 为 2012 年 3 月 20 日。文件将于合作伙伴所在时区的凌晨 4 点至早上 6 点之间生成。
batch_index批次的索引（从零开始）。目前，此值始终为 0。
entity_type文件类型：Partner、Advertiser、InsertionOrder、LineItem、Creative、Pixel、InventorySource、UserList、UniversalChannel 和 summary。
例如，如果您要生成一个文件名来检索 2013 年 4 月 2 日以后访问 line_item 表的合作伙伴 123 的实体读取文件，则您的文件名将如下所示： 
gdbm-123/entity/20130402.0.LineItem.json