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.