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.