Od
8 września 2025 r. każdy nowy element zamówienia będzie musiał deklarować, czy będzie wyświetlać reklamy polityczne w Unii Europejskiej (UE). Przesyłanie plików SDF i wywoływanie interfejsu Display & Video 360 API bez deklaracji zakończy się niepowodzeniem. Więcej informacji o tym, jak zaktualizować integrację, aby złożyć to oświadczenie, znajdziesz na naszej
stronie dotyczącej wycofania.
Method: advertisers.lineItems.bulkEditAssignedTargetingOptions
Zadbaj o dobrą organizację dzięki kolekcji
Zapisuj i kategoryzuj treści zgodnie ze swoimi preferencjami.
Zbiorcze edytowanie opcji kierowania w większej liczbie elementów zamówienia. Ta operacja spowoduje usunięcie przypisanych opcji kierowania podanych w sekcji BulkEditAssignedTargetingOptionsRequest.delete_requests, a następnie utworzy przypisane opcje kierowania podane w sekcji BulkEditAssignedTargetingOptionsRequest.create_requests.
Żądań do tego punktu końcowego nie można przesyłać równocześnie z tymi żądaniami aktualizującymi ten sam element zamówienia:
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/v4/advertisers/{advertiserId}/lineItems:bulkEditAssignedTargetingOptions
Adres URL używa składni transkodowania gRPC.
Parametry ścieżki
| Parametry |
advertiserId |
string (int64 format)
Wymagane. Identyfikator reklamodawcy, do którego należą elementy zamówienia.
|
Treść żądania
Treść żądania zawiera dane o następującej strukturze:
| Pola |
lineItemIds[] |
string (int64 format)
Wymagane. Identyfikator elementów zamówienia, których ustawienia kierowania są aktualizowane.
|
deleteRequests[] |
object (DeleteAssignedTargetingOptionsRequest)
Przypisane opcje kierowania do usunięcia zbiorczo, określone jako lista DeleteAssignedTargetingOptionsRequest. Obsługiwane typy kierowania:
TARGETING_TYPE_AGE_RANGETARGETING_TYPE_APPTARGETING_TYPE_APP_CATEGORYTARGETING_TYPE_AUDIENCE_GROUPTARGETING_TYPE_AUDIO_CONTENT_TYPETARGETING_TYPE_AUTHORIZED_SELLER_STATUSTARGETING_TYPE_BROWSERTARGETING_TYPE_BUSINESS_CHAINTARGETING_TYPE_CARRIER_AND_ISPTARGETING_TYPE_CATEGORYTARGETING_TYPE_CHANNELTARGETING_TYPE_CONTENT_DURATIONTARGETING_TYPE_CONTENT_GENRETARGETING_TYPE_CONTENT_INSTREAM_POSITIONTARGETING_TYPE_CONTENT_OUTSTREAM_POSITIONTARGETING_TYPE_CONTENT_STREAM_TYPETARGETING_TYPE_DAY_AND_TIMETARGETING_TYPE_DEVICE_MAKE_MODELTARGETING_TYPE_DEVICE_TYPETARGETING_TYPE_DIGITAL_CONTENT_LABEL_EXCLUSIONTARGETING_TYPE_ENVIRONMENTTARGETING_TYPE_EXCHANGETARGETING_TYPE_GENDERTARGETING_TYPE_GEO_REGIONTARGETING_TYPE_HOUSEHOLD_INCOMETARGETING_TYPE_INVENTORY_SOURCETARGETING_TYPE_INVENTORY_SOURCE_GROUPTARGETING_TYPE_KEYWORDTARGETING_TYPE_LANGUAGETARGETING_TYPE_NATIVE_CONTENT_POSITIONTARGETING_TYPE_NEGATIVE_KEYWORD_LISTTARGETING_TYPE_OMIDTARGETING_TYPE_ON_SCREEN_POSITIONTARGETING_TYPE_OPERATING_SYSTEMTARGETING_TYPE_PARENTAL_STATUSTARGETING_TYPE_POITARGETING_TYPE_PROXIMITY_LOCATION_LISTTARGETING_TYPE_REGIONAL_LOCATION_LISTTARGETING_TYPE_SENSITIVE_CATEGORY_EXCLUSIONTARGETING_TYPE_SUB_EXCHANGETARGETING_TYPE_THIRD_PARTY_VERIFIERTARGETING_TYPE_URLTARGETING_TYPE_USER_REWARDED_CONTENTTARGETING_TYPE_VIDEO_PLAYER_SIZETARGETING_TYPE_VIEWABILITY
|
createRequests[] |
object (CreateAssignedTargetingOptionsRequest)
Przypisane opcje kierowania do utworzenia w serii, określone jako lista wartości CreateAssignedTargetingOptionsRequest. Obsługiwane typy kierowania:
TARGETING_TYPE_AGE_RANGETARGETING_TYPE_APPTARGETING_TYPE_APP_CATEGORYTARGETING_TYPE_AUDIENCE_GROUPTARGETING_TYPE_AUDIO_CONTENT_TYPETARGETING_TYPE_AUTHORIZED_SELLER_STATUSTARGETING_TYPE_BROWSERTARGETING_TYPE_BUSINESS_CHAINTARGETING_TYPE_CARRIER_AND_ISPTARGETING_TYPE_CATEGORYTARGETING_TYPE_CHANNELTARGETING_TYPE_CONTENT_DURATIONTARGETING_TYPE_CONTENT_GENRETARGETING_TYPE_CONTENT_INSTREAM_POSITIONTARGETING_TYPE_CONTENT_OUTSTREAM_POSITIONTARGETING_TYPE_CONTENT_STREAM_TYPETARGETING_TYPE_DAY_AND_TIMETARGETING_TYPE_DEVICE_MAKE_MODELTARGETING_TYPE_DEVICE_TYPETARGETING_TYPE_DIGITAL_CONTENT_LABEL_EXCLUSIONTARGETING_TYPE_ENVIRONMENTTARGETING_TYPE_EXCHANGETARGETING_TYPE_GENDERTARGETING_TYPE_GEO_REGIONTARGETING_TYPE_HOUSEHOLD_INCOMETARGETING_TYPE_INVENTORY_SOURCETARGETING_TYPE_INVENTORY_SOURCE_GROUPTARGETING_TYPE_KEYWORDTARGETING_TYPE_LANGUAGETARGETING_TYPE_NATIVE_CONTENT_POSITIONTARGETING_TYPE_NEGATIVE_KEYWORD_LISTTARGETING_TYPE_OMIDTARGETING_TYPE_ON_SCREEN_POSITIONTARGETING_TYPE_OPERATING_SYSTEMTARGETING_TYPE_PARENTAL_STATUSTARGETING_TYPE_POITARGETING_TYPE_PROXIMITY_LOCATION_LISTTARGETING_TYPE_REGIONAL_LOCATION_LISTTARGETING_TYPE_SENSITIVE_CATEGORY_EXCLUSIONTARGETING_TYPE_SUB_EXCHANGETARGETING_TYPE_THIRD_PARTY_VERIFIERTARGETING_TYPE_URLTARGETING_TYPE_USER_REWARDED_CONTENTTARGETING_TYPE_VIDEO_PLAYER_SIZETARGETING_TYPE_VIEWABILITY
|
Treść odpowiedzi
W przypadku powodzenia treść żądania zawiera dane o następującej strukturze:
| Zapis JSON |
{
"updatedLineItemIds": [
string
],
"failedLineItemIds": [
string
],
"errors": [
{
object (Status)
}
]
} |
| Pola |
updatedLineItemIds[] |
string (int64 format)
Tylko dane wyjściowe. Identyfikatory elementów zamówienia, które zostały zaktualizowane.
|
failedLineItemIds[] |
string (int64 format)
Tylko dane wyjściowe. Identyfikatory elementów zamówienia, które nie zostały utworzone.
|
errors[] |
object (Status)
Informacje o błędach dotyczące 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 OAuth 2.0 Overview.
O ile nie stwierdzono inaczej, treść tej strony jest objęta licencją Creative Commons – uznanie autorstwa 4.0, a fragmenty kodu są dostępne na licencji Apache 2.0. Szczegółowe informacje na ten temat zawierają zasady dotyczące witryny Google Developers. Java jest zastrzeżonym znakiem towarowym firmy Oracle i jej podmiotów stowarzyszonych.
Ostatnia aktualizacja: 2025-07-25 UTC.
[null,null,["Ostatnia aktualizacja: 2025-07-25 UTC."],[],["The Display & Video 360 API v4 beta allows bulk editing of targeting options across multiple line items. This involves deleting specified assigned targeting options via `deleteRequests` and creating new ones via `createRequests`. Concurrent edits to the same line item using `lineItems.bulkUpdate`, `lineItems.patch`, `assignedTargetingOptions.create`, or `assignedTargetingOptions.delete` are not allowed. The request body includes `lineItemIds`, `deleteRequests`, and `createRequests`, while the response indicates `updatedLineItemIds`, `failedLineItemIds`, and `errors`. The URL for the HTTP request uses gRPC Transcoding syntax. YouTube & Partners line items are not supported.\n"],null,[]]
