החלפת כל האתרים במסגרת ערוץ יחיד.
הפעולה תחליף את האתרים שמתחת לערוץ באתרים שסופקו ב-ReplaceSitesRequest.new_sites
.
לשיטה הזו יש באופן קבוע זמן אחזור גבוה. כדי למנוע שגיאות, מומלץ להקטין את ברירת המחדל של הזמן הקצוב לתפוגה.
בקשת HTTP
POST https://displayvideo.googleapis.com/v2/partners/{partnerId}/channels/{channelId}/sites:replace
בכתובת ה-URL נעשה שימוש בתחביר המרת קידוד של gRPC.
פרמטרים של נתיב
פרמטרים | |
---|---|
channelId |
חובה. המזהה של ערוץ ההורה שהאתרים שלו יוחלפו. |
פרמטר איחוד owner . חובה. מזהה הישות ב-DV360 שערוץ ההורה נמצא בבעלותה. זה יכול להיות שותף או מפרסם. owner יכול להיות רק אחד מהבאים: |
|
partnerId |
המזהה של השותף שהוא הבעלים של ערוץ ההורה. |
גוף הבקשה
גוף הבקשה מכיל נתונים במבנה הבא:
ייצוג JSON |
---|
{ "newSites": [ { object ( |
שדות | |
---|---|
newSites[] |
האתרים שיחליפו את האתרים הקיימים שמוקצים לערוץ, מצוינים כרשימה של |
שדה איחוד owner . חובה. מזהה הישות ב-DV360 שערוץ ההורה נמצא בבעלותה. זה יכול להיות שותף או מפרסם. owner יכול להיות רק אחד מהבאים: |
|
partnerId |
המזהה של השותף שהוא הבעלים של ערוץ ההורה. |
advertiserId |
המזהה של המפרסם שהוא הבעלים של ערוץ ההורה. |
גוף התשובה
אם הפעולה בוצעה ללא שגיאות, גוף התגובה מכיל מופע של ReplaceSitesResponse
.
היקפי הרשאות
נדרש היקף ההרשאות הבא של OAuth:
https://www.googleapis.com/auth/display-video
למידע נוסף, עיינו בסקירה הכללית על OAuth 2.0.