עריכות בכמות גדולה של אפשרויות טירגוט במספר פריטים. הפעולה תמחק את אפשרויות הטירגוט שהוקצו ב-BulkEditAssignedTargetingOptionsRequest.delete_requests
, ולאחר מכן תיצור את אפשרויות הטירגוט שהוקצו ב-BulkEditAssignedTargetingOptionsRequest.create_requests
.
אי אפשר לשלוח בקשות לנקודת הקצה הזאת בו-זמנית עם הבקשות הבאות שמעדכנות את אותו פריט:
lineItems.bulkUpdate
lineItems.patch
assignedTargetingOptions.create
assignedTargetingOptions.delete
לא ניתן ליצור או לעדכן פריטים של YouTube ו-Partners באמצעות ה-API.
בקשת HTTP
POST https://displayvideo.googleapis.com/v3/advertisers/{advertiserId}/lineItems:bulkEditAssignedTargetingOptions
בכתובת ה-URL נעשה שימוש בתחביר המרת gRPC.
פרמטרים של נתיב
פרמטרים | |
---|---|
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.