Method: advertisers.lineItems.bulkUpdate

Atualiza vários itens de linha.

As solicitações para esse endpoint não podem ser feitas ao mesmo tempo que as seguintes solicitações que 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/v3/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, apenas os seguintes campos são compatíveis:

É 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 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.