چندین مورد خط را به روز می کند.
درخواستها به این نقطه پایانی را نمیتوان همزمان با درخواستهای زیر که همان مورد خط را بهروزرسانی میکنند ارائه کرد:
-
lineItems.bulkEditAssignedTargetingOptions
-
lineItems.patch
-
assignedTargetingOptions.create
-
assignedTargetingOptions.delete
موارد خط YouTube & Partners را نمی توان با استفاده از API ایجاد یا به روز کرد.
درخواست HTTP
POST https://displayvideo.googleapis.com/v3/advertisers/{advertiserId}/lineItems:bulkUpdate
URL از دستور GRPC Transcoding استفاده می کند.
پارامترهای مسیر
پارامترها | |
---|---|
advertiserId | مورد نیاز. شناسه تبلیغکنندهای که این مورد خطی به آن تعلق دارد. |
درخواست بدن
بدنه درخواست حاوی داده هایی با ساختار زیر است:
نمایندگی JSON |
---|
{
"lineItemIds": [
string
],
"targetLineItem": {
object ( |
فیلدها | |
---|---|
lineItemIds[] | مورد نیاز. شناسه موارد خط برای بهروزرسانی. |
targetLineItem | مورد نیاز. یک شی مورد خط حاوی فیلدهایی که باید به روز شوند و مقادیر جدید برای تخصیص به همه موارد خط مشخص شده در |
updateMask | مورد نیاز. یک ماسک فیلد که تشخیص می دهد کدام فیلدها را به روز می کند. در حال حاضر فقط فیلدهای زیر پشتیبانی می شوند: این فهرستی از نامهای فیلدهای کاملاً واجد شرایط با کاما است. مثال: |
بدن پاسخگو
پیام پاسخ برای LineItemService.BulkUpdateLineItems.
در صورت موفقیت آمیز بودن، بدنه پاسخ حاوی داده هایی با ساختار زیر است:
نمایندگی JSON |
---|
{
"updatedLineItemIds": [
string
],
"failedLineItemIds": [
string
],
"skippedLineItemIds": [
string
],
"errors": [
{
object ( |
فیلدها | |
---|---|
updatedLineItemIds[] | شناسههای موارد خطی که با موفقیت بهروزرسانی شدند. |
failedLineItemIds[] | شناسه موارد خطی که بهروزرسانی نشدند. |
skippedLineItemIds[] | شناسههای موارد خطی که برای بهروزرسانی نادیده گرفته میشوند. برای مثال، جهشهای غیرضروری که منجر به هیچ تغییری در موارد خطی نمیشوند، نادیده گرفته میشوند و شناسههای مورد خط مربوطه را میتوان در اینجا ردیابی کرد. |
errors[] | خطاهایی که توسط موارد خطی که بهروزرسانی نشدند، برگردانده شدند. |
محدوده مجوز
به محدوده OAuth زیر نیاز دارد:
-
https://www.googleapis.com/auth/display-video
برای اطلاعات بیشتر، به نمای کلی OAuth 2.0 مراجعه کنید.