Lineitems: uploadlineitems
تنظيم صفحاتك في مجموعات
يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
يحمِّل العناصر بتنسيق CSV. YouTube تفاصيل إعلانات الشركاء غير متاحة.
تجربة ذلك الآن
الطلب
طلب HTTP
POST https://www.googleapis.com/doubleclickbidmanager/v1.1/lineitems/uploadlineitems
التفويض
يتطلب هذا الطلب تفويضًا بالنطاق التالي:
النطاق |
https://www.googleapis.com/auth/doubleclickbidmanager |
لمزيد من المعلومات، يُرجى الاطّلاع على صفحة المصادقة والتفويض.
نص الطلب
في نص الطلب، وفِّر البيانات بالبنية التالية:
{
"lineItems": string,
"format": string,
"dryRun": boolean
}
اسم الموقع |
القيمة |
الوصف |
ملاحظات |
lineItems |
string |
العناصر في ملف CSV المطلوب تحميلها. لمزيد من المعلومات حول تنسيقات الملفات، راجع تنسيق ملف كتابة الكيانات. |
|
format |
string |
تنسيق العناصر يتم ضبط الإعداد التلقائي على CSV .
في ما يلي القيم المقبولة:
|
|
dryRun |
boolean |
اضبط القيمة على true للحصول على حالة التحميل بدون الاحتفاظ بالعناصر. |
|
الرد
في حال نجاح هذه الطريقة، سيتم عرض نص استجابة بالبنية التالية:
{
"uploadStatus": {
"errors": [
string
],
"rowStatus": [
{
"rowNumber": integer,
"entityId": long,
"entityName": string,
"changed": boolean,
"persisted": boolean,
"errors": [
string
]
}
]
}
}
اسم الموقع |
القيمة |
الوصف |
ملاحظات |
uploadStatus |
nested object |
حالة التحميل |
|
uploadStatus.errors[] |
list |
أسباب تعذّر إكمال التحميل. |
|
uploadStatus.rowStatus[] |
list |
حالة التحميل على مستوى كل صف |
|
uploadStatus.rowStatus[].rowNumber |
integer |
رقم الصف. |
|
uploadStatus.rowStatus[].entityId |
long |
معرّف الكيان. |
|
uploadStatus.rowStatus[].entityName |
string |
اسم الجهة. |
|
uploadStatus.rowStatus[].changed |
boolean |
ما إذا كان قد تم تغيير الكيان المخزَّن نتيجة التحميل. |
|
uploadStatus.rowStatus[].persisted |
boolean |
ما إذا كان الكيان مستمرًا أم لا. |
|
uploadStatus.rowStatus[].errors[] |
list |
أسباب تعذُّر تحميل العنصر |
|
جرّب الآن
يمكنك استخدام "مستكشف واجهات برمجة التطبيقات" أدناه لطلب هذه الطريقة على البيانات المباشرة والاطّلاع على الردّ.
ويمكنك بدلاً من ذلك تجربة
مستقل
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 in Bid Manager API is discontinued and users should transition to the DV360 API.\u003c/p\u003e\n"],["\u003cp\u003eThis documentation details the process for uploading line items in CSV format using the \u003ccode\u003euploadlineitems\u003c/code\u003e endpoint in the Bid Manager API, though YouTube & partners line items are not supported.\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\u003eThe API provides options to perform a dry run to check upload status without persisting data and returns detailed upload status including errors and per-row information.\u003c/p\u003e\n"]]],["The Bid Manager API's Line Items Settings service is discontinued; users must switch to the DV360 API. The `uploadlineitems` method allows uploading line items in CSV format, excluding YouTube & partners line items. It accepts a request body with `lineItems` (CSV data), `format` (defaulting to CSV), and `dryRun` (boolean for testing). The response details upload status, including errors and per-row information like row number, entity details, and persistence status. Authorization via `https://www.googleapis.com/auth/doubleclickbidmanager` is required.\n"],null,["# Lineitems: uploadlineitems\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\nUploads 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/uploadlineitems\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 \"lineItems\": string,\n \"format\": string,\n \"dryRun\": boolean\n}\n```\n\n| Property name | Value | Description | Notes |\n|---------------|-----------|------------------------------------------------------------------------------------------------------------------------------------------------|-------|\n| `lineItems` | `string` | Line items in CSV to upload. For more information about file formats, see [Entity Write File Format](/bid-manager/guides/entity-write/format). | |\n| `format` | `string` | Format the line items are in. Default to `CSV`. \u003cbr /\u003e Acceptable values are: - \"`CSV`\" | |\n| `dryRun` | `boolean` | Set to `true` to get upload status without actually persisting the line items. | |\n\nResponse\n--------\n\nIf successful, this method returns a response body with the following structure:\n\n```gdscript\n{\n \"uploadStatus\": {\n \"errors\": [\n string\n ],\n \"rowStatus\": [\n {\n \"rowNumber\": integer,\n \"entityId\": long,\n \"entityName\": string,\n \"changed\": boolean,\n \"persisted\": boolean,\n \"errors\": [\n string\n ]\n }\n ]\n }\n}\n```\n\n| Property name | Value | Description | Notes |\n|---------------------------------------|-----------------|-------------------------------------------------------------|-------|\n| `uploadStatus` | `nested object` | Status of upload. | |\n| uploadStatus.`errors[]` | `list` | Reasons why upload can't be completed. | |\n| uploadStatus.`rowStatus[]` | `list` | Per-row upload status. | |\n| uploadStatus.rowStatus[].`rowNumber` | `integer` | Row number. | |\n| uploadStatus.rowStatus[].`entityId` | `long` | Entity Id. | |\n| uploadStatus.rowStatus[].`entityName` | `string` | Entity name. | |\n| uploadStatus.rowStatus[].`changed` | `boolean` | Whether the stored entity is changed as a result of upload. | |\n| uploadStatus.rowStatus[].`persisted` | `boolean` | Whether the entity is persisted. | |\n| uploadStatus.rowStatus[].`errors[]` | `list` | Reasons why the entity can't be uploaded. | |\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.uploadlineitems)."]]