Typ filtra używany do filtrowania elementów zamówienia do pobrania.
Akceptowane wartości to:
„ADVERTISER_ID”
„INSERTION_ORDER_ID”
„LINE_ITEM_ID”
filterIds[]
list
Identyfikatory określonego typu filtra używane do filtrowania elementów zamówienia do pobrania. W przeciwnym razie zwrócone zostaną wszystkie elementy zamówienia.
format
string
Format, w którym elementy zamówienia będą zwracane. Domyślna wartość to CSV.
Akceptowane wartości to:
„CSV”
fileSpec
string
Specyfikacja pliku (nazwy kolumn, typy, kolejność), w której będą zwracane elementy zamówienia. Domyślna wartość to EWF.
Akceptowane wartości to:
„EWF”
Odpowiedź
Jeśli operacja się uda, metoda zwróci odpowiedź o następującej strukturze:
{
"lineItems": string
}
Nazwa usługi
Wartość
Opis
Uwagi
lineItems
string
Pobrano elementy zamówienia w formacie CSV. Więcej informacji o formatach plików znajdziesz w artykule Format pliku zapisu elementów.
Wypróbuj
Użyj poniższego eksploratora interfejsów API, aby wywołać tę metodę na bieżących danych i wyświetlić odpowiedź.
Możesz też wypróbować
samodzielna
Eksplorator.
[null,null,["Ostatnia aktualizacja: 2025-07-25 UTC."],[[["\u003cp\u003eThe Line Items Settings service within the Bid Manager API is discontinued and users should transition to the DV360 API.\u003c/p\u003e\n"],["\u003cp\u003eThis documentation details the process for retrieving line items in CSV format using the \u003ccode\u003edownloadlineitems\u003c/code\u003e method, excluding YouTube & partners line items.\u003c/p\u003e\n"],["\u003cp\u003eThe request requires authorization with the \u003ccode\u003ehttps://www.googleapis.com/auth/doubleclickbidmanager\u003c/code\u003e scope.\u003c/p\u003e\n"],["\u003cp\u003eUsers can specify filters based on advertiser ID, insertion order ID, or line item ID to refine the data retrieved.\u003c/p\u003e\n"]]],["The Bid Manager API's Line Items Settings service is discontinued; users must switch to the DV360 API. To retrieve line items, send a POST request with authorization to the specified endpoint. The request body should include filter type, filter IDs, format (default CSV), and file specification (default EWF). The response will contain line items in CSV format as a string. YouTube line items are not included.\n"],null,["# Lineitems: downloadlineitems\n\nThe Line Items Settings 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 line items in CSV format. YouTube \\& partners line items are not supported.\n[Try it now](#try-it).\n\nRequest\n-------\n\n### HTTP request\n\n```\nPOST https://www.googleapis.com/doubleclickbidmanager/v1.1/lineitems/downloadlineitems\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 \"filterType\": string,\n \"filterIds\": [\n long\n ],\n \"format\": string,\n \"fileSpec\": string\n}\n```\n\n| Property name | Value | Description | Notes |\n|---------------|----------|-----------------------------------------------------------------------------------------------------------------------------------------------------|-------|\n| `filterType` | `string` | Filter type used to filter line items to fetch. \u003cbr /\u003e Acceptable values are: - \"`ADVERTISER_ID`\" - \"`INSERTION_ORDER_ID`\" - \"`LINE_ITEM_ID`\" | |\n| `filterIds[]` | `list` | IDs of the specified filter type used to filter line items to fetch. If omitted, all the line items will be returned. | |\n| `format` | `string` | Format in which the line items will be returned. Default to `CSV`. \u003cbr /\u003e Acceptable values are: - \"`CSV`\" | |\n| `fileSpec` | `string` | File specification (column names, types, order) in which the line items will be returned. Default to `EWF`. \u003cbr /\u003e Acceptable values are: - \"`EWF`\" | |\n\nResponse\n--------\n\nIf successful, this method returns a response body with the following structure:\n\n```text\n{\n \"lineItems\": string\n}\n```\n\n| Property name | Value | Description | Notes |\n|---------------|----------|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|-------|\n| `lineItems` | `string` | Retrieved line items in CSV format. For more information about file formats, see [Entity Write File Format](https://developers.google.com/bid-manager/guides/entity-write/format). | |\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.lineitems.downloadlineitems)."]]
