Method: advertisers.lineItems.bulkUpdate

Atualiza vários itens de linha.

As solicitações para esse endpoint não podem ser feitas simultaneamente com as seguintes solicitações de atualização do mesmo item de linha:

YouTube e Não é possível criar ou atualizar itens de linha de parceiros usando a API.

Solicitação HTTP

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

O URL usa a sintaxe de transcodificação gRPC.

Parâmetros de caminho

Parâmetros
advertiserId

string (int64 format)

Obrigatório. O ID do anunciante ao qual este item de linha pertence.

Corpo da solicitação

O corpo da solicitação contém dados com a seguinte estrutura:

Representação JSON
{
  "lineItemIds": [
    string
  ],
  "targetLineItem": {
    object (LineItem)
  },
  "updateMask": string
}
Campos
lineItemIds[]

string (int64 format)

Obrigatório. IDs dos itens de linha a serem atualizados.

targetLineItem

object (LineItem)

Obrigatório. Um objeto de item de linha que contém os campos a serem atualizados e os novos valores a serem atribuídos a todos os itens de linha especificados em lineItemIds.

updateMask

string (FieldMask format)

Obrigatório. Uma máscara de campo que identifica quais campos atualizar.

No momento, apenas os seguintes campos são aceitos:

É uma lista separada por vírgulas de nomes de campos totalmente qualificados. Exemplo: "user.displayName,photo".

Corpo da resposta

Mensagem de resposta para ItemService.BulkUpdateOrders.

Se bem-sucedido, o corpo da resposta incluirá dados com a estrutura a seguir:

Representação JSON
{
  "updatedLineItemIds": [
    string
  ],
  "failedLineItemIds": [
    string
  ],
  "skippedLineItemIds": [
    string
  ],
  "errors": [
    {
      object (Status)
    }
  ]
}
Campos
updatedLineItemIds[]

string (int64 format)

Os IDs dos itens de linha atualizados.

failedLineItemIds[]

string (int64 format)

IDs dos itens de linha que não foram atualizados.

skippedLineItemIds[]

string (int64 format)

Os IDs dos itens de linha que são ignorados para atualizações. Por exemplo, modificações desnecessárias que resultarão em efetivamente nenhuma alteração nos itens de linha serão ignoradas e os códigos dos itens de linha correspondentes podem ser rastreados aqui.

errors[]

object (Status)

Erros retornados por itens de linha que não foram atualizados.

Escopos de autorização

Requer o seguinte escopo OAuth:

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

Para mais informações, consulte a Visão geral do OAuth 2.0.