Method: partners.channels.sites.bulkEdit

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

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

בקשת HTTP

POST https://displayvideo.googleapis.com/v5/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.