항목 읽기 파일 액세스
컬렉션을 사용해 정리하기
내 환경설정을 기준으로 콘텐츠를 저장하고 분류하세요.
항목 읽기 파일은 파트너의 캠페인 객체를 JSON으로 표현한 것입니다. 항목 읽기 파일은 읽기 전용이며 Google Display & Video 360에 변경사항을 써서 저장하는 데 사용할 수 없습니다. Entity Read Files 사용에 관해 자세히 알아보려면 계정 관리자에게 문의하세요. 계정 관리자가 고객님의 요구사항을 자세히 논의해 드릴 수 있습니다.
항목 읽기 파일은 처리일로부터 60일 동안만 사용할 수 있습니다.
항목 읽기 파일의 형식은 파일 형식 참조에서 확인할 수 있습니다.
항목 읽기 파일은 두 그룹으로 저장됩니다.
gdbm-public 버킷에 저장된 브라우저 버전 또는 언어에 관한 정보와 같은 일반적인 공개 데이터가 포함된 공개 표- 파트너의 캠페인, 예산, 기타 비공개 데이터에 관한 정보가 포함된 비공개 테이블 비공개 테이블은 파트너별 버킷에 저장됩니다. 예를 들어 파트너 ID가 123인 경우 비공개 테이블이 포함된 버킷은
gdbm-123입니다.
공개 테이블과 비공개 테이블이 모두 버킷 내
entity 하위 디렉터리에 있습니다.
하위 디렉터리 처리에 관한 자세한 내용은
Cloud Storage 객체 네임스페이스를 참고하세요.
공개 표는 오전 5시(UTC)에 생성됩니다. 비공개 테이블은 파트너의 시간대 기준 오전 5시에 생성되며 (드물지만 지연될 수 있음)
Google Cloud Storage에 자동으로 안전하게 저장됩니다. 모든 공개 및 비공개 테이블이 생성된 후에 요약 파일이 생성됩니다.
공개 테이블
gdbm-public/entity/(processing_date).(batch_index).(entity_type).json
| 필드 | 설명 |
|---|
processing_date | Display & Video 360에서 데이터를 처리한 날짜이며 파일에 포함된 이벤트와 반드시 관련이 있는 것은 아닙니다. 날짜 형식은 YYYYMMDD입니다. 예를 들어 20120320는 2012년 3월 20일입니다. |
batch_index |
0부터 시작하는 일괄 처리 색인입니다. 예를 들어 매시간 생성되는 경우 첫 번째 배치는 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_date | Display &Video 360에서 데이터를 처리한 날짜입니다. 이 날짜는 파일에 포함된 일정과 반드시 관련이 있는 것은 아닙니다. 날짜 형식은 YYYYMMDD입니다. 예를 들어 20120320은 2012년 3월 20일을 나타냅니다. 파일은 파트너의 시간대에서 오전 4시에서 오전 6시 사이에 생성됩니다. |
batch_index | 0부터 시작하는 일괄 처리 색인입니다. 현재 이 값은 항상 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
달리 명시되지 않는 한 이 페이지의 콘텐츠에는 Creative Commons Attribution 4.0 라이선스에 따라 라이선스가 부여되며, 코드 샘플에는 Apache 2.0 라이선스에 따라 라이선스가 부여됩니다. 자세한 내용은 Google Developers 사이트 정책을 참조하세요. 자바는 Oracle 및/또는 Oracle 계열사의 등록 상표입니다.
최종 업데이트: 2025-08-31(UTC)
[null,null,["최종 업데이트: 2025-08-31(UTC)"],[[["\u003cp\u003eEntity Read Files (ERF) have been discontinued and users should migrate to the Display & Video 360 API.\u003c/p\u003e\n"],["\u003cp\u003eEntity Read Files provided read-only JSON representations of a partner's campaign data but were not capable of writing back changes.\u003c/p\u003e\n"],["\u003cp\u003eThese files were organized into public tables, containing common data like browser versions, and private tables, containing partner-specific campaign data, within respective Google Cloud Storage buckets.\u003c/p\u003e\n"],["\u003cp\u003ePublic tables were generated daily at 5 AM UTC, while private tables were generated at 5 AM in the partner's timezone and stored with a specific naming convention indicating the processing date, batch index, and entity type.\u003c/p\u003e\n"],["\u003cp\u003eEach public and private table has a \u003ccode\u003eprocessing_date\u003c/code\u003e and \u003ccode\u003ebatch_index\u003c/code\u003e as well as an \u003ccode\u003eentity_type\u003c/code\u003e to indicate what type of data is contained within the table.\u003c/p\u003e\n"]]],[],null,["# Access Entity Read Files\n\n| Entity Read Files have sunset. [Migrate to use the\n| Display \\& Video 360 API.](/display-video/api/guides/how-tos/erf-migration)\n\nEntity Read Files are JSON representations of a partner's campaign objects. Entity Read Files\nare read-only and cannot be used to write-back changes to Google Display \\& Video 360. To learn more about using\nEntity Read Files, contact your account manager, who will be able to discuss your needs in more detail.\n\nNote that Entity Read Files are available only for 60 days from their processing date.\n\nThe format of the entity read files can be viewed in the\n[File Format reference](/bid-manager/guides/entity-read/format-v2).\n\nThe entity read files are stored as two groups: \n\n- Public tables, which contain common public data, such as information about browser versions or languages that are stored in the `gdbm-public` bucket.\n- Private tables, which contain information about the partner's campaigns, budgets, and other private data. Private tables are stored in partner-specific buckets; for example, if your partner ID is 123, the bucket that contained your private tables would be `gdbm-123`.\n\nBoth public and private tables are in an `entity` subdirectory within the bucket. For more information about handling subdirectories, see [Cloud Storage object namespace](/storage/docs/objects#namespace). \nThe public tables are generated at 5AM UTC. The private tables are generated at 5AM in your partner's timezone (although in rare cases there may be delays) and stored automatically and securely in [Google Cloud Storage](/storage). A summary file is generated after all of the public and private tables have been generated. All filenames are case-sensitive.\n\nPublic Tables\n-------------\n\n```\ngdbm-public/entity/(processing_date).(batch_index).(entity_type).json\n```\n\n| Field | Description |\n|-------------------|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `processing_date` | The date when Display \\& Video 360 processed the data and is not necessarily related to the events contained within the file. Date format is `YYYYMMDD`, for example `20120320` would be March 20, 2012. |\n| `batch_index` | A zero-based index of the batch. For example, if generated hourly the first batch would be `0`, the second batch would be `1`, and so on. |\n| `entity_type` | The type of file: `SupportedExchange`, `DataPartner`, `UniversalSite`, `GeoLocation`, `Language`, `OperatingSystem`, `Browser`, `Isp`, `summary` and `SiteIdToPlacementId.csv`. |\n\nFor example, if you were generating a filename to retrieve the entity read file for the `browser` table from January 15th, 2013, the path to the file would look like \n\n```\ngdbm-public/entity/20130115.0.Browser.json\n```\n\nPrivate Tables\n--------------\n\n```\ngdbm-(partner_id)/entity/(processing_date).(batch_index).(entity_type).json\n```\n\n| Field | Description |\n|-------------------|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `partner_id` | The numeric ID of your Partner. |\n| `processing_date` | The date when Display \\& Video 360 processed the data. This date is not necessarily related to the events contained within the file. Date format is `YYYYMMDD`, for example `20120320` would be March 20, 2012. The files will be generated between 4AM and 6AM in the Partner's timezone. |\n| `batch_index` | A zero-based index of the batch. Currently this is always 0. |\n| `entity_type` | The type of file: `Partner`, `Advertiser`, `InsertionOrder`, `LineItem`, `Creative`, `Pixel`, `InventorySource`, `UserList`, `UniversalChannel`, and `summary`. |\n\nFor example, if you were generating a file name to retrieve the entity read file for partner 123 accessing the `line_item` table from April 2, 2013, your filename would look something like this: \n\n```\ngdbm-123/entity/20130402.0.LineItem.json\n```"]]
