Method: advertisers.channels.sites.bulkEdit

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

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

בקשת HTTP

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

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

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

פרמטרים
channelId

string (int64 format)

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

פרמטר האיחוד owner. חובה. מזהה את הישות ב-DV360 שערוץ ההורה נמצא בבעלותה. הם יכולים להיות שותפים או מפרסמים. owner יכול להיות רק אחת מהאפשרויות הבאות:
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.