Method: advertisers.channels.sites.bulkEdit

עריכה בכמות גדולה של אתרים בערוץ אחד.

הפעולה תמחק את האתרים שצוינו ב-BulkEditSitesRequest.deleted_sites ולאחר מכן תיצור את האתרים שסופקו ב-BulkEditSitesRequest.created_sites.

בקשת HTTP

POST https://displayvideo.googleapis.com/v1/advertisers/{advertiserId}/channels/{channelId}/sites:bulkEdit

בכתובת ה-URL נעשה שימוש בתחביר המרת gRPC.

פרמטרים של נתיב

פרמטרים
channelId

string (int64 format)

חובה. המזהה של ערוץ ההורה שאליו האתרים שייכים.
advertiserId

string (int64 format)

המזהה של המפרסם שהוא הבעלים של ערוץ ההורה.

גוף הבקשה

גוף הבקשה מכיל נתונים במבנה הבא:

ייצוג JSON 
{
  "deletedSites": [
    string
  ],
  "createdSites": [
    {
      object (Site)
    }
  ],

  // Union field owner can be only one of the following:
  "partnerId": string
  // End of list of possible types for union field owner.
}
שדות
deletedSites[]

string

האתרים למחיקה בקבוצה, מצוינים כרשימה של האתרים url_or_app_ids.
createdSites[]

object (Site)

האתרים ליצירה בקבוצה, מצוינים כרשימה של Sites.
שדה איחוד owner. חובה. מזהה את הישות ב-DV360 שערוץ ההורה נמצא בבעלותה. זה יכול להיות שותף או מפרסם. הערך של owner יכול להיות רק אחת מהאפשרויות הבאות:
partnerId

string (int64 format)

המזהה של השותף שבבעלותו נמצא ערוץ ההורה.
advertiserId

string (int64 format)

המזהה של המפרסם שהוא הבעלים של ערוץ ההורה.

גוף התגובה

אם הפעולה בוצעה ללא שגיאות, גוף התגובה יכלול מופע של BulkEditSitesResponse.

היקפי הרשאות

נדרש היקף OAuth הבא:

  • https://www.googleapis.com/auth/display-video

למידע נוסף, עיין בסקירה הכללית על OAuth 2.0.