REST Resource: sellers.products

Recurso: product

Um único produto.

Representação JSON
{
  "name": string,
  "externalId": string,
  "displayName": string,
  "description": string,
  "labels": {
    string: string,
    ...
  },
  "creativeSpecifications": [
    {
      object (CreativeSpecification)
    }
  ],
  "bookingLeadDuration": string,
  "assignmentLeadDuration": string,
  "minFlightDuration": string,
  "maxFlightDuration": string,
  "slotDuration": string,
  "createTime": string,
  "updateTime": string,
  "state": enum (State),
  "currencyCode": string
}
Campos
name

string

O nome de recurso do produto no formato: sellers/{seller}/products/{product}. Por exemplo, sellers/seller111/products/product123.

externalId

string

Um ID usado para mapear esta entidade para origens externas.

displayName

string

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

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

description

string

Campo de formato livre adicional para descrever o produto.

labels

map (key: string, value: string)

O conjunto de rótulos de forma livre para descrever este produto.

Um objeto com uma lista de pares "key": value. Exemplo: { "name": "wrench", "mass": "1.3kg", "count": "3" }.

creativeSpecifications[]

object (CreativeSpecification)

Obrigatório. Lista de criativos permitidos que podem ser veiculados para este produto.

bookingLeadDuration

string (Duration format)

Obrigatório. A duração do lead é necessária para reservar o produto. Now + bookingLeadDuration precisa ser posterior ao início do voo.

Uma duração em segundos com até nove dígitos fracionários, encerrada por "s". Exemplo: "3.5s".

assignmentLeadDuration

string (Duration format)

Obrigatório. A duração do lead é necessária para atribuir criativos.

Uma duração em segundos com até nove dígitos fracionários, encerrada por "s". Exemplo: "3.5s".

minFlightDuration

string (Duration format)

Duração mínima do voo para este produto.

Uma duração em segundos com até nove dígitos fracionários, encerrada por "s". Exemplo: "3.5s".

maxFlightDuration

string (Duration format)

Obrigatório. Duração máxima do voo para este produto.

Uma duração em segundos com até nove dígitos fracionários, encerrada por "s". Exemplo: "3.5s".

slotDuration

string (Duration format)

Obrigatório. Duração do slot deste produto.

Uma duração em segundos com até nove dígitos fracionários, encerrada por "s". Exemplo: "3.5s".

createTime

string (Timestamp format)

Apenas saída. Carimbo de data/hora de criação do produto.

Um carimbo de data/hora no formato RFC3339 UTC "Zulu", com resolução de nanossegundos e até nove dígitos fracionários. Exemplos: "2014-10-02T15:01:23Z" e "2014-10-02T15:01:23.045123456Z".

updateTime

string (Timestamp format)

Apenas saída. Carimbo de data/hora da última atualização do produto.

Um carimbo de data/hora no formato RFC3339 UTC "Zulu", com resolução de nanossegundos e até nove dígitos fracionários. Exemplos: "2014-10-02T15:01:23Z" e "2014-10-02T15:01:23.045123456Z".

state

enum (State)

Apenas saída. O estado do produto.

currencyCode

string

Obrigatório. O código de moeda com três letras maiúsculas definido no ISO 4217.

Estado

Valores possíveis para o estado do produto.

Enums
STATE_UNSPECIFIED Valor padrão quando o estado do produto não está especificado ou é desconhecido nesta versão.
STATE_ACTIVE O produto, a campanha e o grupo de anúncios do produto estão ativos,
STATE_DELETED O produto foi excluído.

Métodos

create

Cria um novo produto.

delete

Exclui um produto existente.

get

Recupera um produto individual.

list

Lista os produtos.

patch

Atualiza um produto existente.