Method: partners.channels.sites.replace

הפונקציה מחליפה את כל האתרים בערוץ יחיד.

הפעולה תחליף את האתרים בערוץ באתרים שצוינו ב-ReplaceSitesRequest.new_sites.

בשיטה הזו יש בדרך כלל זמן אחזור ארוך. כדי להימנע משגיאות, מומלץ להגדיל את זמן הקצוב לתפוגה שמוגדר כברירת מחדל.

בקשת HTTP

POST https://displayvideo.googleapis.com/v3/partners/{partnerId}/channels/{channelId}/sites:replace

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

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

פרמטרים
channelId

string (int64 format)

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

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

string (int64 format)

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

גוף הבקשה

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

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

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

object (Site)

האתרים שיחליפו את האתרים הקיימים שהוקצו לערוץ, מפורטים כרשימה של Sites.

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

string (int64 format)

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

advertiserId

string (int64 format)

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

גוף התשובה

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

היקפי הרשאה

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

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

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