Method: partners.channels.sites.replace

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

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

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

בקשת HTTP

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

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

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

פרמטרים
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.