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 ou atualizar itens de linha do YouTube e parceiros usando a API.

Solicitação HTTP

POST https://displayvideo.googleapis.com/v5/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 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 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 foram ignorados nas atualizações. Por exemplo, mutações desnecessárias que não resultam em mudanças nos itens de linha serão ignoradas, e os IDs dos itens de linha correspondentes poderão 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.