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