指定廣告空間來源:從已發布的 SDF 廣告交易平台參考資料,擷取這些資料欄中使用的廣告交易平台 ID。使用 Display & Video 360 API,擷取這些資料欄中使用的廣告空間來源 ID 和子交易平台 ID。
應用程式指定目標:從相關應用程式平台擷取這些資料欄中使用的應用程式 ID。
如果您已使用 Display & Video 360 API
透過大量建立及更新 YouTube 與合作夥伴資源,使用 SDF 支援 Display & Video 360 API 整合。
使用 SDF 上傳功能更新 YouTube 與合作夥伴資源
您無法使用 Display & Video 360 API 建立或更新 YouTube 與合作夥伴資源,例如特定類型的委刊項、廣告群組和廣告。您可以擷取這些資源的設定和已指派的指定目標,但任何更新都必須透過 Display & Video 360 介面進行。這會限制大量動作,並限制更新這些資源的速率。
使用結構化資料檔案上傳功能,透過 Display & Video 360 介面大量建立或更新 YouTube 和合作夥伴資源。您必須手動上傳結構化資料檔案,但可以透過程式完成大部分程序,也就是擷取及修改檔案。
[null,null,["上次更新時間:2025-08-26 (世界標準時間)。"],[[["\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."]]