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 que atualizam o mesmo item de linha:

Não é possível criar nem 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 a que 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, mutações desnecessárias que não resultam em mudanças nos itens de linha são ignoradas, e os IDs 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 OAuth 2.0 Overview.