Types de fichiers renvoyés. Si INVENTORY_SOURCE est demandé, aucun autre type de fichier ne peut être demandé.
Les valeurs possibles sont les suivantes:
"AD"
"AD_GROUP"
"CAMPAIGN"
"INSERTION_ORDER"
"INVENTORY_SOURCE"
"LINE_ITEM"
filterType
string
Type de filtre utilisé pour filtrer les entités à extraire. Vous ne pouvez utiliser PARTNER_ID et INVENTORY_SOURCE_ID que lors du téléchargement de sources d'inventaire.
Les valeurs possibles sont les suivantes:
<ph type="x-smartling-placeholder">
</ph>
"ADVERTISER_ID"
"CAMPAIGN_ID"
"INSERTION_ORDER_ID"
"INVENTORY_SOURCE_ID"
"LINE_ITEM_ID"
"PARTNER_ID"
filterIds[]
list
ID du type de filtre spécifié. Permet de filtrer les entités à récupérer. Vous devez indiquer au moins un identifiant. Un seul ID est autorisé pour le type de filtre ADVERTISER_ID. Pour les types de filtres INSERTION_ORDER_ID ou LINE_ITEM_ID, tous les ID doivent provenir du même annonceur.
version
string
Version du fichier SDF (noms des colonnes, types et ordre) dans laquelle les entités seront renvoyées. Valeur par défaut : 5.3
Réponse
Si la requête aboutit, cette méthode renvoie un corps de réponse présentant la structure suivante :
Les groupes d'annonces ont été récupérés au format SDF.
ads
string
Annonces récupérées au format SDF.
campaigns
string
Campagnes récupérées au format SDF.
inventorySources
string
Essayer
Utilisez l'explorateur d'API ci-dessous pour appeler cette méthode sur des données en direct, puis observez la réponse.
Vous pouvez également essayer
autonome
un navigateur Web.
Sauf indication contraire, le contenu de cette page est régi par une licence Creative Commons Attribution 4.0, et les échantillons de code sont régis par une licence Apache 2.0. Pour en savoir plus, consultez les Règles du site Google Developers. Java est une marque déposée d'Oracle et/ou de ses sociétés affiliées.
Dernière mise à jour le 2025/07/25 (UTC).
[null,null,["Dernière mise à jour le 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)."]]
