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