Zastępuje wszystkie witryny w ramach jednego kanału.
Ta operacja zastąpi witryny w kanale witrynami podanymi w parametrze ReplaceSitesRequest.new_sites.
Ta metoda regularnie charakteryzuje się długim czasem oczekiwania. Aby uniknąć błędów, zalecamy zwiększenie domyślnego limitu czasu.
Żądanie HTTP
POST https://displayvideo.googleapis.com/v4/advertisers/{advertiserId}/channels/{channelId}/sites:replace
Adres URL używa składni transkodowania gRPC.
Parametry ścieżki
| Parametry | |
|---|---|
channelId |
Wymagane. Identyfikator kanału nadrzędnego, którego witryny zostaną zastąpione. |
| Wymagane. Określa podmiot DV360, który jest właścicielem kanału nadrzędnego. Może to być partner lub reklamodawca. Poniżej znajduje się lista pól, które się wzajemnie wykluczają. W odpowiedzi zostanie ustawione co najwyżej jedno z tych pól: | |
advertiserId |
Identyfikator reklamodawcy, który jest właścicielem kanału nadrzędnego. |
| Koniec pól wykluczających się nawzajem. | |
Treść żądania
Treść żądania zawiera dane o następującej strukturze:
| Zapis JSON |
|---|
{
"newSites": [
{
object ( |
| Pola | |
|---|---|
newSites[] |
Witryny, które zastąpią dotychczasowe witryny przypisane do kanału, podane jako lista |
| Wymagane. Określa podmiot DV360, który jest właścicielem kanału nadrzędnego. Może to być partner lub reklamodawca. Poniżej znajduje się lista pól, które się wzajemnie wykluczają. W odpowiedzi zostanie ustawione co najwyżej jedno z tych pól: | |
partnerId |
Identyfikator partnera, który jest właścicielem kanału nadrzędnego. |
advertiserId |
Identyfikator reklamodawcy, który jest właścicielem kanału nadrzędnego. |
| Koniec pól wykluczających się nawzajem. | |
Treść odpowiedzi
W przypadku powodzenia treść odpowiedzi obejmuje wystąpienie elementu ReplaceSitesResponse.
Zakresy autoryzacji
Wymaga następującego zakresu OAuth:
https://www.googleapis.com/auth/display-video
Więcej informacji znajdziesz w OAuth 2.0 Overview.