Method: partners.channels.sites.bulkEdit

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

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

בקשת HTTP

POST https://displayvideo.googleapis.com/v4/partners/{partnerId}/channels/{channelId}/sites:bulkEdit

כתובת ה-URL כתובה בתחביר של gRPC Transcoding.

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

פרמטרים
channelId

string (int64 format)

חובה. המזהה של ערוץ ההורה שאליו האתרים שייכים.
חובה. מזהה את הישות ב-DV360 שהיא הבעלים של ערוץ האב. הוא יכול להיות שותף או מפרסם. הרשימה הבאה כוללת שדות שאי אפשר להשתמש בהם בו-זמנית. בכל תשובה יוגדר לכל היותר אחד מהשדות:
partnerId

string (int64 format)

המזהה של השותף הראשי שהוא הבעלים של ערוץ ההורה.
סוף השדות הבלעדיים.

גוף הבקשה

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

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

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "advertiserId": string
  // End of mutually exclusive fields.
}
שדות
deletedSites[]

string

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

object (Site)

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

string (int64 format)

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

string (int64 format)

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

גוף התשובה

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

היקפי הרשאות

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

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

ניתן למצוא מידע נוסף כאן: OAuth 2.0 Overview.