Zbiorcze edytowanie opcji kierowania w wielu elementach zamówienia. Operacja spowoduje usunięcie przypisanych opcji kierowania określonych w polu BulkEditAssignedTargetingOptionsRequest.delete_requests
, a następnie utworzenie przypisanych opcji kierowania dostępnych w interfejsie BulkEditAssignedTargetingOptionsRequest.create_requests
.
Żądania wysyłane do tego punktu końcowego nie mogą być wysyłane jednocześnie z tymi żądaniami powodującymi aktualizację tego samego elementu zamówienia:
lineItems.bulkUpdate
lineItems.patch
assignedTargetingOptions.create
assignedTargetingOptions.delete
Elementów zamówienia typu YouTube i sieć partnerów wideo Google nie można tworzyć ani aktualizować za pomocą interfejsu API.
Żądanie HTTP
POST https://displayvideo.googleapis.com/v3/advertisers/{advertiserId}/lineItems:bulkEditAssignedTargetingOptions
Adres URL używa składni transkodowania gRPC.
Parametry ścieżki
Parametry | |
---|---|
advertiserId |
To pole jest wymagane. Identyfikator reklamodawcy, do którego należą elementy zamówienia. |
Treść żądania
Treść żądania zawiera dane o następującej strukturze:
Zapis JSON |
---|
{ "lineItemIds": [ string ], "deleteRequests": [ { object ( |
Pola | |
---|---|
lineItemIds[] |
To pole jest wymagane. Identyfikatory elementów zamówienia, których kierowanie jest aktualizowane. |
deleteRequests[] |
Przypisane opcje kierowania do usunięcia zbiorczo, określone na liście Obsługiwane typy kierowania:
|
createRequests[] |
Przypisane opcje kierowania do utworzenia zbiorcze, określone na liście Obsługiwane typy kierowania:
|
Treść odpowiedzi
W przypadku powodzenia treść żądania zawiera dane o następującej strukturze:
Zapis JSON |
---|
{
"updatedLineItemIds": [
string
],
"failedLineItemIds": [
string
],
"errors": [
{
object ( |
Pola | |
---|---|
updatedLineItemIds[] |
Tylko dane wyjściowe. Identyfikatory elementów zamówienia, które zostały zaktualizowane. |
failedLineItemIds[] |
Tylko dane wyjściowe. Identyfikatory elementów zamówienia, w przypadku których nie udało się zrealizować transakcji. |
errors[] |
Informacje o błędach w przypadku każdego elementu zamówienia, którego nie udało się zaktualizować. |
Zakresy autoryzacji
Wymaga następującego zakresu OAuth:
https://www.googleapis.com/auth/display-video
Więcej informacji znajdziesz w artykule Omówienie protokołu OAuth 2.0.