Method: advertisers.channels.sites.replace

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

הפעולה תחליף את האתרים בערוץ באתרים שצוינו ב-ReplaceSitesRequest.new_sites.

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

בקשת HTTP

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

כתובת ה-URL משתמשת בתחביר של Transcoding של 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.