Zastępuje wszystkie witryny w ramach jednego kanału.
Operacja zastąpi witryny w kanale witrynami podanymi w parametrze ReplaceSitesRequest.new_sites
.
W przypadku tej metody często występują duże opóźnienia. Aby uniknąć błędów, zalecamy zwiększenie domyślnego limitu czasu.
Żądanie HTTP
POST https://displayvideo.googleapis.com/v3/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. |
Parametr zbiorczy owner . Wymagane. Identyfikuje podmiot DV360, który jest właścicielem kanału nadrzędnego. Może to być partner lub reklamodawca. owner może mieć tylko jedną z tych wartości: |
|
advertiserId |
Identyfikator reklamodawcy, który jest właścicielem kanału nadrzędnego. |
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 |
Pole zbiorcze owner . Wymagane. Identyfikuje podmiot DV360, który jest właścicielem kanału nadrzędnego. Może to być partner lub reklamodawca. owner może mieć tylko jedną z tych wartości: |
|
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. |
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 sekcji OAuth 2.0 Overview.