Method: advertisers.lineItems.bulkUpdate

Atualiza vários itens de linha.

Não é possível fazer solicitações para este endpoint ao mesmo tempo que as seguintes solicitações atualizam o mesmo item de linha:

Não é possível criar ou atualizar itens de linha do YouTube e 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 serão atualizados.

No momento, somente 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 LineItemService.BulkUpdateLineItems.

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)

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

skippedLineItemIds[]

string (int64 format)

Os códigos dos itens de linha que foram ignorados para atualizações. Por exemplo, as mudanças desnecessárias que resultarão na ausência de alterações nos itens de linha serão ignoradas, e os IDs 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.