- Solicitud HTTP
- Parámetros de ruta de acceso
- Cuerpo de la solicitud
- Cuerpo de la respuesta
- Permisos de autorización
- Pruébala
Actualiza varias líneas de pedido.
Las solicitudes a este extremo no se pueden realizar de forma simultánea con las siguientes solicitudes que actualizan la misma línea de pedido:
lineItems.bulkEditAssignedTargetingOptions
lineItems.patch
assignedTargetingOptions.create
assignedTargetingOptions.delete
Las líneas de pedido de YouTube & Partners no se pueden crear ni actualizar con la API.
Solicitud HTTP
POST https://displayvideo.googleapis.com/v3/advertisers/{advertiserId}/lineItems:bulkUpdate
La URL usa la sintaxis de la transcodificación gRPC.
Parámetros de ruta de acceso
Parámetros | |
---|---|
advertiserId |
Obligatorio. Indica el ID del anunciante al que pertenece esta línea de pedido. |
Cuerpo de la solicitud
El cuerpo de la solicitud contiene datos con la siguiente estructura:
Representación JSON |
---|
{
"lineItemIds": [
string
],
"targetLineItem": {
object ( |
Campos | |
---|---|
lineItemIds[] |
Obligatorio. IDs de las líneas de pedido que se actualizarán. |
targetLineItem |
Obligatorio. Un objeto de línea de pedido que contiene los campos que se actualizarán y los valores nuevos que se deben asignar a todas las líneas de pedido especificadas en |
updateMask |
Obligatorio. Una máscara de campo que identifica los campos que se actualizarán. Actualmente, solo se admiten los siguientes campos: Esta es una lista separada por comas de los nombres de campos completamente calificados. Ejemplo: |
Cuerpo de la respuesta
Mensaje de respuesta para LineItemService.BulkUpdateLineItems.
Si se ejecuta correctamente, el cuerpo de la respuesta contendrá datos con la siguiente estructura:
Representación JSON |
---|
{
"updatedLineItemIds": [
string
],
"failedLineItemIds": [
string
],
"skippedLineItemIds": [
string
],
"errors": [
{
object ( |
Campos | |
---|---|
updatedLineItemIds[] |
Son los ID de las líneas de pedido actualizadas correctamente. |
failedLineItemIds[] |
Los IDs de las líneas de pedido que no se pudieron actualizar. |
skippedLineItemIds[] |
Los ID de las líneas de pedido que se omiten para las actualizaciones Por ejemplo, aquí se pueden realizar mutaciones innecesarias que no generarán ningún cambio en las líneas de pedido y hacer un seguimiento de los IDs de las líneas de pedido correspondientes. |
errors[] |
Errores que muestran las líneas de pedido que no se pudieron 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 la Descripción general de OAuth 2.0.