Method: advertisers.lineItems.bulkUpdate

Actualiza varias líneas de pedido.

Las solicitudes a este endpoint no se pueden realizar de forma simultánea con las siguientes solicitudes que actualizan la misma línea de pedido:

Las líneas de pedido de YouTube & Partners no se pueden crear ni actualizar con la API.

Solicitud HTTP

POST https://displayvideo.googleapis.com/v4/advertisers/{advertiserId}/lineItems:bulkUpdate

La URL usa la sintaxis de la transcodificación gRPC.

Parámetros de ruta de acceso

Parámetros
advertiserId

string (int64 format)

Es obligatorio. Es 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 (LineItem)
  },
  "updateMask": string
}
Campos
lineItemIds[]

string (int64 format)

Es obligatorio. Son los IDs de las líneas de pedido que se actualizarán.
targetLineItem

object (LineItem)

Es obligatorio. Es un objeto de elemento de una sola línea que contiene los campos que se actualizarán y los valores nuevos que se asignarán a todos los elementos de una sola línea especificados en lineItemIds".
updateMask

string (FieldMask format)

Es obligatorio. Es una máscara de campo que identifica qué campos se deben actualizar.

Actualmente, solo se admiten los siguientes campos:

Esta es una lista separada por comas de los nombres de campos totalmente calificados. Ejemplo: "user.displayName,photo".

Cuerpo de la respuesta

Es el 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 (Status)
    }
  ]
}
Campos
updatedLineItemIds[]

string (int64 format)

Son los IDs de las líneas de pedido que se actualizaron correctamente.
failedLineItemIds[]

string (int64 format)

Son los IDs de las líneas de pedido que no se pudieron actualizar.
skippedLineItemIds[]

string (int64 format)

Son los IDs de las líneas de pedido que se omiten para las actualizaciones. Por ejemplo, se omitirán las mutaciones innecesarias que no generen cambios efectivos en las líneas de pedido, y los IDs de las líneas de pedido correspondientes se pueden hacer un seguimiento aquí.
errors[]

object (Status)

Son los errores que devolvieron los elementos de la línea que no se pudieron actualizar.

Permisos de autorización

Requiere el siguiente permiso de OAuth:

  • https://www.googleapis.com/auth/display-video

Para obtener más información, consulta OAuth 2.0 Overview.