Method: advertisers.lineItems.generateDefault

Cria um novo item de linha com configurações (incluindo a segmentação) herdadas do pedido de inserção e um entityStatus ENTITY_STATUS_DRAFT. Retorna o item de linha recém-criado se a operação for bem-sucedida. Há valores padrão com base nos três campos:

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:generateDefault

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 o item de linha pertence.

Corpo da solicitação

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

Representação JSON
{
  "insertionOrderId": string,
  "displayName": string,
  "lineItemType": enum (LineItemType),
  "mobileApp": {
    object (MobileApp)
  }
}
Campos
insertionOrderId

string (int64 format)

Obrigatório. O ID exclusivo do pedido de inserção ao qual o item de linha pertence.

displayName

string

Obrigatório. O nome de exibição do item de linha.

Precisa ser codificado em UTF-8 com um tamanho máximo de 240 bytes.

lineItemType

enum (LineItemType)

Obrigatório. O tipo do item de linha.

mobileApp

object (MobileApp)

O app para dispositivos móveis promovido pelo item de linha.

Isso só é aplicável quando lineItemType é LINE_ITEM_TYPE_DISPLAY_MOBILE_APP_INSTALL ou LINE_ITEM_TYPE_VIDEO_MOBILE_APP_INSTALL.

Corpo da resposta

Se a solicitação for bem-sucedida, o corpo da resposta conterá uma instância de LineItem.

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.