Method: partners.channels.sites.replace

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

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

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

בקשת HTTP

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

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

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

פרמטרים
channelId

string (int64 format)

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

string (int64 format)

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

גוף הבקשה

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

ייצוג ב-JSON 
{
  "newSites": [
    {
      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.
}
שדות
newSites[]

object (Site)

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

string (int64 format)

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

string (int64 format)

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

גוף התשובה

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

היקפי הרשאות

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

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

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