Method: advertisers.channels.sites.replace

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

הפעולה תחליף את האתרים שמתחת לערוץ באתרים שסופקו ב-ReplaceSitesRequest.new_sites.

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

בקשת HTTP

POST https://displayvideo.googleapis.com/v2/advertisers/{advertiserId}/channels/{channelId}/sites:replace

בכתובת ה-URL נעשה שימוש בתחביר המרת קידוד של gRPC.

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

פרמטרים
channelId

string (int64 format)

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

string (int64 format)

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

גוף הבקשה

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

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

  // Union field owner can be only one of the following:
  "partnerId": 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.