Lineitems: downloadlineitems
تنظيم صفحاتك في مجموعات
يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
يسترجع العناصر بتنسيق CSV. YouTube تفاصيل إعلانات الشركاء غير متاحة.
تجربة ذلك الآن
الطلب
طلب HTTP
POST https://www.googleapis.com/doubleclickbidmanager/v1.1/lineitems/downloadlineitems
التفويض
يتطلب هذا الطلب تفويضًا بالنطاق التالي:
| النطاق |
|---|
https://www.googleapis.com/auth/doubleclickbidmanager |
لمزيد من المعلومات، يُرجى الاطّلاع على صفحة المصادقة والتفويض.
نص الطلب
في نص الطلب، وفِّر البيانات بالبنية التالية:
{
"filterType": string,
"filterIds": [
long
],
"format": string,
"fileSpec": string
}
| اسم الموقع |
القيمة |
الوصف |
ملاحظات |
filterType |
string |
نوع الفلتر المستخدَم لفلترة العناصر من أجل استرجاعها
في ما يلي القيم المقبولة:
- "
ADVERTISER_ID"
- "
INSERTION_ORDER_ID"
- "
LINE_ITEM_ID"
|
|
filterIds[] |
list |
أرقام تعريف نوع الفلتر المحدَّد المستخدَم لفلترة العناصر من أجل استرجاعها وفي حال حذفها، سيتم عرض جميع العناصر. |
|
format |
string |
التنسيق الذي سيتم عرض العناصر به يتم ضبط الإعداد التلقائي على CSV.
في ما يلي القيم المقبولة:
|
|
fileSpec |
string |
مواصفات الملف (أسماء الأعمدة والأنواع والترتيب) التي سيتم عرض العناصر بها. يتم ضبط الإعداد التلقائي على EWF.
في ما يلي القيم المقبولة:
|
|
الرد
في حال نجاح هذه الطريقة، سيتم عرض نص استجابة بالبنية التالية:
{
"lineItems": string
}
| اسم الموقع |
القيمة |
الوصف |
ملاحظات |
lineItems |
string |
تمّ استرجاع العناصر بتنسيق ملف CSV. لمزيد من المعلومات حول تنسيقات الملفات، راجع تنسيق ملف كتابة الكيانات. |
|
جرّب الآن
يمكنك استخدام "مستكشف واجهات برمجة التطبيقات" أدناه لطلب هذه الطريقة على البيانات المباشرة والاطّلاع على الردّ.
ويمكنك بدلاً من ذلك تجربة
مستقل
Explorer (المستكشف):
إنّ محتوى هذه الصفحة مرخّص بموجب ترخيص Creative Commons Attribution 4.0 ما لم يُنصّ على خلاف ذلك، ونماذج الرموز مرخّصة بموجب ترخيص Apache 2.0. للاطّلاع على التفاصيل، يُرجى مراجعة سياسات موقع Google Developers. إنّ Java هي علامة تجارية مسجَّلة لشركة Oracle و/أو شركائها التابعين.
تاريخ التعديل الأخير: 2025-07-25 (حسب التوقيت العالمي المتفَّق عليه)
[null,null,["تاريخ التعديل الأخير: 2025-07-25 (حسب التوقيت العالمي المتفَّق عليه)"],[[["\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)."]]
