Display & Video 360 API를 사용하여 파일 및 관련 메타데이터의 프로그래매틱 검색을 통해 SDF 통합을 지원합니다.
API를 사용하여 파일 생성 및 다운로드
기본적으로 Display & Video 360 인터페이스를 사용하여 구조화된 데이터 파일을 수동으로 다운로드합니다. 이러한 다운로드는 일반적으로 단일 광고주로 제한되며 특정 리소스 페이지에서 시작해야 합니다. 인터페이스를 통해 많은 SDF 데이터를 다운로드하는 것은 복잡하고 시간이 오래 걸릴 수 있습니다.
Display & Video 360 API를 사용하여 프로그래매틱 방식으로 구조화된 데이터 파일을 생성하고 다운로드하여 이 프로세스를 간소화하세요. 이 기능을 구현하는 방법에 관한 단계별 안내는 가이드를 참고하세요.
API를 사용하여 참조 ID 조회
구조화된 데이터 파일은 Display & Video 360 리소스의 구성을 반영합니다.
대부분의 SDF 열은 숫자 ID를 사용하여 다른 리소스 또는 타겟팅 구성을 식별합니다. SDF 데이터를 읽고 수정할 때 이러한 ID를 이해하려면 참조가 필요한 경우가 많습니다.
Display & Video 360 API를 사용하여 참조 정보를 일괄적으로 가져옵니다. 관련 리소스의 GET 또는 LIST 함수를 사용하여 대부분의 SDF 열에서 사용하는 사용 가능한 ID를 가져올 수 있습니다.
구조화된 데이터 파일을 파싱하고 수정할 때 캐시된 정보를 사용하도록 참조 정보를 프로그래매틱 방식으로 가져오고 캐시합니다. 캐시를 정기적으로 업데이트하고 필요한 경우 SDF를 파싱하여 새 리소스에 관한 정보를 가져올 때 알 수 없는 ID를 실시간으로 조회할 수 있습니다.
구조화된 데이터 파일에서 사용하는 일부 참조 ID는 Display & Video 360 API를 사용하여 가져올 수 없습니다.
관심분야 및 구매 의도 타겟팅: Display & Video 360 인터페이스에서 이러한 열에 사용된 잠재고객 ID를 가져옵니다.
전환 플러드라이트 활동 ID: Display & Video 360 인터페이스에서 이러한 열에 사용된 플러드라이트 활동 ID를 가져옵니다.
인벤토리 소스 타겟팅: 게시된 SDF 광고 거래소 참조에서 이러한 열에 사용된 광고 거래소 ID를 가져옵니다. Display & Video 360 API를 사용하여 이러한 열에 사용된 인벤토리 소스 ID와 하위 거래소 ID를 가져옵니다.
앱 타겟팅: 관련 앱 플랫폼에서 이러한 열에 사용된 앱 ID를 가져옵니다.
Display & Video 360 API를 이미 사용 중인 경우
SDF를 사용하여 YouTube + 파트너 리소스의 일괄 생성 및 업데이트를 통해 Display & Video 360 API 통합을 지원합니다.
SDF 업로드를 사용하여 YouTube 및 파트너 리소스 업데이트
Display & Video 360 API를 사용하여 특정 유형의 광고 항목, 광고 그룹, 광고와 같은 YouTube + 파트너 리소스를 만들거나 업데이트할 수 없습니다. 이러한 리소스의 구성과 할당된 타겟팅을 가져올 수 있지만 업데이트는 Display & Video 360 인터페이스를 통해 실행해야 합니다. 이렇게 하면 일괄 작업이 제한되고 이러한 리소스를 업데이트할 수 있는 속도가 제한됩니다.
구조화된 데이터 파일 업로드를 사용하여 Display & Video 360 인터페이스를 통해 YouTube 및 파트너 리소스를 일괄적으로 만들거나 업데이트합니다. 구조화된 데이터 파일은 수동으로 업로드해야 하지만 파일 검색 및 수정과 같은 대부분의 프로세스는 프로그래매틱 방식으로 완료할 수 있습니다.
[null,null,["최종 업데이트: 2025-08-26(UTC)"],[[["\u003cp\u003eThis page explains how to customize the appearance of your Programmable Search Engine's search box and results, either through the control panel or by using XML.\u003c/p\u003e\n"],["\u003cp\u003eYou can customize various components like layout, search box, results display, refinements, promotions, and logo (for Google-hosted results) to match your website's design.\u003c/p\u003e\n"],["\u003cp\u003eChoose from various Search Element layouts to control how the search box and results are displayed on your webpage, including options like overlay, two-page, full-width, and compact.\u003c/p\u003e\n"],["\u003cp\u003eImplement your design by copying the code snippet provided after saving your changes and paste it into the \u003ccode\u003e<body>\u003c/code\u003e section of your webpages where you want the search element to appear.\u003c/p\u003e\n"],["\u003cp\u003eConsider using the 'compact' layout for optimal display on mobile devices and remember that autocompletion is available for search engines covering specific sites, not the entire web.\u003c/p\u003e\n"]]],["Structured Data Files (SDF) and the Display & Video 360 API facilitate bulk management of resource configurations, each with limitations. The API can programmatically generate and download SDFs and retrieve reference IDs, improving efficiency. For YouTube & Partners resources, which the API can't update, use SDF uploads for bulk actions. While some IDs are not accessible via the API, the guide outlines alternative methods to locate them. Combining both tools optimizes bulk management capabilities.\n"],null,["Both [Structured Data Files (SDF)](/display-video/api/structured-data-file/format) and [Display \\& Video 360 API](/display-video/api/guides/getting-started/overview)\nsupport bulk management of Display \\& Video 360 resource configurations. Each\ntool has unique limitations. This guide suggests ways to optimize your existing\nimplementation by using both tools.\n\nIf you already use Structured Data Files\n\nUse the Display \\& Video 360 API to support your SDF integration through programmatic\nretrieval of the files and relevant metadata.\n\nGenerate and download files using the API\n\nBy default, you download Structured Data Files manually using the\nDisplay \\& Video 360 interface. These downloads are generally restricted to a single\nadvertiser and must be initiated from specific resource pages. Downloading a lot\nof SDF data through the interface can be complex and time-consuming.\n\nStreamline this process by generating and downloading Structured Data Files\nprogrammatically using the Display \\& Video 360 API. Read [our guide](/display-video/api/guides/downloading-sdfs/create)\nfor step-by-step instructions on how to implement this feature.\n\nLook up reference IDs using the API\n\nStructured Data Files reflect the configurations of Display \\& Video 360 resources.\nMost SDF columns use numeric IDs to identify other resources or targeting\nconfigurations. You often need a reference to understand these IDs when reading\nand modifying SDF data.\n\nUse the Display \\& Video 360 API to retrieve reference information in bulk. You can retrieve\nthe available IDs used by most SDF columns using the relevant resource's `GET`\nor `LIST` functions.\n\nRetrieve and cache reference information programmatically to use that cached\ninformation when parsing and modifying your Structured Data Files. You can\nregularly update your cache and, if needed, lookup unknown IDs in real time when\nparsing your SDFs to retrieve information on new resources.\n\nRead the [API reference documentation](/display-video/api/reference/rest/current) for an exhaustive list of\navailable API services and methods.\n\nExisting exceptions\n\nA small number of reference IDs used by Structured Data Files can't be retrieved\nusing the Display \\& Video 360 API:\n\n- **Affinity \\& In Market Targeting**: Retrieve Audience IDs used in these columns from the Display \\& Video 360 interface.\n- **Conversion Floodlight Activity Ids**: Retrieve Floodlight Activity IDs used in these columns from the Display \\& Video 360 interface.\n- **Inventory Source Targeting** : Retrieve Exchange IDs used in these columns from the [published SDF exchange reference](/display-video/api/structured-data-file/exchange-reference). Retrieve Inventory source IDs and sub-exchange IDs used in these columns using the Display \\& Video 360 API.\n- **App Targeting**: Retrieve App IDs used in these columns from the relevant app platform.\n\nIf you already use the Display \\& Video 360 API\n\nUse SDF to support your Display \\& Video 360 API integration through bulk creation and\nupdating of YouTube \\& Partners resources.\n| **Caution:** Starting **September 8, 2025** , you must use v9 to upload Structured Data Files. *If your advertiser has declared that it will not serve European* *Union (EU) political ads, you can continue to use previous versions to upload* *SDFs.*\n\nUpdate YouTube \\& Partners resources using SDF upload\n\nYou can't create or update YouTube \\& Partners resources, such as specific types\nof line items, ad groups, and ads, using the Display \\& Video 360 API. You can retrieve\nconfigurations and assigned targeting for these resources, but any updates must\nbe done through the Display \\& Video 360 interface. This restricts bulk actions and\nlimits the rate at which you can update these resources.\n\nUse Structured Data Files upload to create or update YouTube \\& Partners\nresources in bulk through the Display \\& Video 360 interface. While you must upload\nStructured Data Files manually, you can complete the majority of the process,\nnamely retrieving and modifying the files, programmatically.\n\nRead the [API guide on downloading SDFs](/display-video/api/guides/downloading-sdfs/create) and the\n[documentation on SDF upload](//support.google.com/displayvideo/answer/6301070) for more information."]]
