Loại tệp sẽ được trả về. Nếu có yêu cầu INVENTORY_SOURCE, thì không thể yêu cầu loại tệp nào khác.
Các giá trị có thể chấp nhận là:
"AD"
"AD_GROUP"
"CAMPAIGN"
"INSERTION_ORDER"
"INVENTORY_SOURCE"
"LINE_ITEM"
filterType
string
Loại bộ lọc dùng để lọc các mục cần tìm nạp. Bạn chỉ có thể sử dụng PARTNER_ID và INVENTORY_SOURCE_ID khi tải nguồn khoảng không quảng cáo xuống.
Các giá trị được chấp nhận là:
"ADVERTISER_ID"
"CAMPAIGN_ID"
"INSERTION_ORDER_ID"
"INVENTORY_SOURCE_ID"
"LINE_ITEM_ID"
"PARTNER_ID"
filterIds[]
list
Mã của loại bộ lọc được chỉ định. Tham số này được dùng để lọc các thực thể cần tìm nạp. Bạn phải chỉ định ít nhất một mã nhận dạng. Chỉ được dùng một mã nhận dạng cho loại bộ lọc ADVERTISER_ID. Đối với loại bộ lọc INSERTION_ORDER_ID hoặc LINE_ITEM_ID, tất cả các mã nhận dạng phải thuộc cùng một Nhà quảng cáo.
version
string
Phiên bản SDF (tên cột, loại, thứ tự) mà các thực thể sẽ được trả về. Giá trị mặc định là 5.3.
Phản hồi
Nếu thành công, phương thức này sẽ trả về nội dung phản hồi có cấu trúc như sau:
Đã truy xuất đơn đặt hàng quảng cáo ở định dạng SDF.
lineItems
string
Các mục hàng đã truy xuất ở định dạng SDF.
adGroups
string
Các nhóm quảng cáo được truy xuất ở định dạng SDF.
ads
string
Quảng cáo được truy xuất ở định dạng SDF.
campaigns
string
Chiến dịch được truy xuất ở định dạng SDF.
inventorySources
string
Hãy dùng thử!
Hãy sử dụng APIs Explorer (Trình khám phá API) bên dưới để gọi phương thức này trên dữ liệu trực tiếp và xem phản hồi.
Ngoài ra, hãy thử
độc lập
Trình khám phá.
[null,null,["Cập nhật lần gần đây nhất: 2025-07-25 UTC."],[[["\u003cp\u003eThe SDF Download service of the Bid Manager API is discontinued and users should transition to the DV360 API for similar functionality.\u003c/p\u003e\n"],["\u003cp\u003eThe DV360 API's SDF download requires authorization with the \u003ccode\u003ehttps://www.googleapis.com/auth/doubleclickbidmanager\u003c/code\u003e scope.\u003c/p\u003e\n"],["\u003cp\u003eUsers can retrieve entities like campaigns, insertion orders, line items, ad groups, ads, and inventory sources in SDF format using the new API.\u003c/p\u003e\n"],["\u003cp\u003eThe request body for the DV360 API allows for filtering downloaded entities by type and ID, and specifying the SDF version for the output.\u003c/p\u003e\n"]]],["The SDF Download service is deprecated; users should migrate to the DV360 API. To retrieve entities in SDF format, a POST request is made to the specified endpoint, requiring authorization. The request body includes `fileTypes` (e.g., AD, CAMPAIGN), `filterType` (e.g., ADVERTISER_ID), `filterIds` (IDs corresponding to filter type), and `version`. The response contains strings representing downloaded entities such as `insertionOrders`, `lineItems`, `ads`, `campaigns`, `adGroups` and `inventorySources` in SDF format.\n"],null,["# Sdf: download\n\nThe SDF Download service of the Bid Manager API has been sunset. Users must migrate to the [DV360 API](/display-video/api/reference/rest). \n| **Note:** Requires [authorization](#auth).\n\nRetrieves entities in SDF format.\n[Try it now](#try-it).\n\nRequest\n-------\n\n### HTTP request\n\n```\nPOST https://www.googleapis.com/doubleclickbidmanager/v1.1/sdf/download\n```\n\n### Authorization\n\nThis request requires authorization with the following scope:\n\n| Scope |\n|---------------------------------------------------------|\n| `https://www.googleapis.com/auth/doubleclickbidmanager` |\n\nFor more information, see the [authentication and authorization](/bid-manager/how-tos/authorizing) page.\n\n### Request body\n\nIn the request body, supply data with the following structure:\n\n```text\n{\n \"fileTypes\": [\n string\n ],\n \"filterType\": string,\n \"filterIds\": [\n long\n ],\n \"version\": string\n}\n```\n\n| Property name | Value | Description | Notes |\n|---------------|----------|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|-------|\n| `fileTypes[]` | `list` | File types that will be returned. If INVENTORY_SOURCE is requested, no other file types may be requested. Acceptable values are: - \"`AD`\" - \"`AD_GROUP`\" - \"`CAMPAIGN`\" - \"`INSERTION_ORDER`\" - \"`INVENTORY_SOURCE`\" - \"`LINE_ITEM`\" | |\n| `filterType` | `string` | Filter type used to filter entities to fetch. PARTNER_ID and INVENTORY_SOURCE_ID may only be used when downloading inventory sources. \u003cbr /\u003e Acceptable values are: - \"`ADVERTISER_ID`\" - \"`CAMPAIGN_ID`\" - \"`INSERTION_ORDER_ID`\" - \"`INVENTORY_SOURCE_ID`\" - \"`LINE_ITEM_ID`\" - \"`PARTNER_ID`\" | |\n| `filterIds[]` | `list` | The IDs of the specified filter type. This is used to filter entities to fetch. At least one ID must be specified. Only one ID is allowed for the `ADVERTISER_ID` filter type. For `INSERTION_ORDER_ID` or `LINE_ITEM_ID` filter types all IDs must be from the same Advertiser. | |\n| `version` | `string` | SDF Version (column names, types, order) in which the entities will be returned. Default to `5.3`. | |\n\nResponse\n--------\n\nIf successful, this method returns a response body with the following structure:\n\n```text\n{\n \"campaigns\": string,\n \"insertionOrders\": string,\n \"lineItems\": string,\n \"adGroups\": string,\n \"ads\": string,\n \"inventorySources\": string\n}\n```\n\n| Property name | Value | Description | Notes |\n|--------------------|----------|-------------------------------------------|-------|\n| `insertionOrders` | `string` | Retrieved insertion orders in SDF format. | |\n| `lineItems` | `string` | Retrieved line items in SDF format. | |\n| `adGroups` | `string` | Retrieved ad groups in SDF format. | |\n| `ads` | `string` | Retrieved ads in SDF format. | |\n| `campaigns` | `string` | Retrieved campaigns in SDF format. | |\n| `inventorySources` | `string` | | |\n\nTry it!\n-------\n\n\nUse the APIs Explorer below to call this method on live data and see the response.\nAlternatively, try the\n[standalone\nExplorer](https://developers.google.com/apis-explorer/#p/doubleclickbidmanager/v1.1/doubleclickbidmanager.sdf.download)."]]
