Method: advertisers.channels.sites.replace

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

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

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

בקשת HTTP

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

כתובת ה-URL כתובה בתחביר של gRPC Transcoding.

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

פרמטרים
channelId

string (int64 format)

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

string (int64 format)

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

גוף הבקשה

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

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

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "partnerId": string
  // End of mutually exclusive fields.
}
שדות
newSites[]

object (Site)

האתרים שיחליפו את האתרים הקיימים שהוקצו לערוץ, מצוינים כרשימה של Sites.
חובה. מזהה את הישות ב-DV360 שהיא הבעלים של הערוץ הראשי. הגורם יכול להיות שותף או מפרסם. זו רשימה של שדות שמוציאים זה את זה. בתשובה יוגדר לכל היותר אחד מהשדות הבאים:
partnerId

string (int64 format)

המזהה של השותף שבבעלותו ערוץ ההורה.
advertiserId

string (int64 format)

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

גוף התשובה

אם הפעולה בוצעה ללא שגיאות, גוף התגובה יכיל מופע של ReplaceSitesResponse.

היקפי הרשאות

נדרש היקף ההרשאות הבא של OAuth:

  • https://www.googleapis.com/auth/display-video

ניתן למצוא מידע נוסף כאן: OAuth 2.0 Overview.