A partir del
8 de septiembre de 2025, cada elemento de la línea nuevo deberá declarar si publicará anuncios políticos de la Unión Europea (UE). Las cargas de la API de Display & Video 360 y del SDF que no proporcionen declaraciones fallarán. Consulta nuestra
página de bajas para obtener más detalles sobre cómo actualizar tu integración y realizar esta declaración.
Method: advertisers.lineItems.bulkEditAssignedTargetingOptions
Organiza tus páginas con colecciones
Guarda y categoriza el contenido según tus preferencias.
Edita de forma masiva las opciones de segmentación en varias líneas de pedido. La operación borrará las opciones de segmentación asignadas proporcionadas en BulkEditAssignedTargetingOptionsRequest.delete_requests y, luego, creará las opciones de segmentación asignadas proporcionadas en BulkEditAssignedTargetingOptionsRequest.create_requests.
Las solicitudes a este extremo no se pueden realizar de forma simultánea con las siguientes solicitudes que actualizan el mismo elemento de una sola línea:
No se pueden crear ni actualizar líneas de pedido de YouTube y socios con la API.
Solicitud HTTP
POST https://displayvideo.googleapis.com/v4/advertisers/{advertiserId}/lineItems:bulkEditAssignedTargetingOptions
La URL usa la sintaxis de la transcodificación gRPC.
Parámetros de ruta de acceso
| Parámetros |
advertiserId |
string (int64 format)
Obligatorio. Es el ID del anunciante al que pertenecen las líneas de pedido.
|
Cuerpo de la solicitud
El cuerpo de la solicitud contiene datos con la siguiente estructura:
| Campos |
lineItemIds[] |
string (int64 format)
Obligatorio. Es el ID de las líneas de pedido cuya segmentación se está actualizando.
|
deleteRequests[] |
object (DeleteAssignedTargetingOptionsRequest)
Las opciones de segmentación asignadas que se borrarán de forma masiva, especificadas como una lista de DeleteAssignedTargetingOptionsRequest. Entre los tipos de segmentación admitidos, se incluyen los siguientes:
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)
Las opciones de segmentación asignadas para crear en lotes, especificadas como una lista de CreateAssignedTargetingOptionsRequest. Entre los tipos de segmentación admitidos, se incluyen los siguientes:
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
|
Cuerpo de la respuesta
Si el proceso es satisfactorio, el cuerpo de la respuesta contiene datos con la siguiente estructura:
| Representación JSON |
{
"updatedLineItemIds": [
string
],
"failedLineItemIds": [
string
],
"errors": [
{
object (Status)
}
]
} |
| Campos |
updatedLineItemIds[] |
string (int64 format)
Solo salida. Los IDs de las líneas de pedido que se actualizaron correctamente
|
failedLineItemIds[] |
string (int64 format)
Solo salida. Los IDs de las líneas de pedido que fallaron
|
errors[] |
object (Status)
La información de error de cada línea de pedido que no se pudo actualizar
|
Permisos de autorización
Requiere el siguiente alcance de OAuth:
https://www.googleapis.com/auth/display-video
Para obtener más información, consulta OAuth 2.0 Overview.
Salvo que se indique lo contrario, el contenido de esta página está sujeto a la licencia Atribución 4.0 de Creative Commons, y los ejemplos de código están sujetos a la licencia Apache 2.0. Para obtener más información, consulta las políticas del sitio de Google Developers. Java es una marca registrada de Oracle o sus afiliados.
Última actualización: 2025-07-25 (UTC)
[null,null,["Última actualización: 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,[]]
