REST Resource: guaranteedOrders

Recurso: GarantidoOrder

Um pedido garantido.

Os pedidos garantidos são a entidade pai das origens de inventário garantidas. Ao criar uma origem de inventário garantida, um código de pedido garantido precisa ser atribuído a ela.

Representação JSON 
{
  "name": string,
  "legacyGuaranteedOrderId": string,
  "exchange": enum (Exchange),
  "guaranteedOrderId": string,
  "displayName": string,
  "status": {
    object (GuaranteedOrderStatus)
  },
  "updateTime": string,
  "publisherName": string,
  "readAccessInherited": boolean,
  "readAdvertiserIds": [
    string
  ],
  "defaultAdvertiserId": string,
  "defaultCampaignId": string,

  // Union field read_write_accessor can be only one of the following:
  "readWritePartnerId": string,
  "readWriteAdvertiserId": string
  // End of list of possible types for union field read_write_accessor.
}
Campos
name

string

Apenas saída. O nome de recurso do pedido garantido.
legacyGuaranteedOrderId

string

Apenas saída. O código legado do pedido garantido. Atribuído pela troca original. O código legado é exclusivo em uma troca, mas não é garantido que ele seja único em todos os pedidos garantidos. Esse ID é usado no SDF e na interface.
exchange

enum (Exchange)

Obrigatório. Imutável. A troca em que o pedido garantido foi originado.
guaranteedOrderId

string

Apenas saída. O identificador exclusivo do pedido garantido. Os códigos de pedido garantidos têm o formato {exchange}-{legacyGuaranteedOrderId}.
displayName

string

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

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

object (GuaranteedOrderStatus)

As configurações de status do pedido garantido.
updateTime

string (Timestamp format)

Apenas saída. O carimbo de data/hora em que o pedido garantido foi atualizado pela última vez. Atribuído pelo sistema.

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".
publisherName

string

Obrigatório. O nome do editor do pedido garantido.

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

boolean

Se todos os anunciantes de readWritePartnerId têm acesso de leitura ao pedido garantido. Aplicável apenas se readWritePartnerId estiver definido. Se verdadeiro, substitui readAdvertiserIds.
readAdvertiserIds[]

string (int64 format)

Os IDs dos anunciantes com acesso de leitura ao pedido garantido.

Esse campo não poderá incluir o anunciante atribuído a readWriteAdvertiserId se ele estiver definido. Todos os anunciantes neste campo precisam pertencer a readWritePartnerId ou ao mesmo parceiro que readWriteAdvertiserId.
defaultAdvertiserId

string (int64 format)

Apenas saída. O ID do anunciante padrão do pedido garantido.

O anunciante padrão é readWriteAdvertiserId ou, se isso não estiver definido, o primeiro anunciante listado no readAdvertiserIds. Caso contrário, não há um anunciante padrão.
defaultCampaignId

string (int64 format)

O ID da campanha padrão que é atribuído ao pedido garantido.

A campanha padrão precisa pertencer ao anunciante padrão.

Campo de união read_write_accessor. Obrigatório.

O parceiro ou anunciante com acesso de leitura/gravação ao pedido garantido. read_write_accessor pode ser apenas de um dos tipos a seguir:
readWritePartnerId

string (int64 format)

O parceiro com acesso de leitura/gravação ao pedido garantido.
readWriteAdvertiserId

string (int64 format)

O anunciante com acesso de leitura/gravação ao pedido garantido. Este também é o anunciante padrão do pedido garantido.

GuaranteedOrderStatus

As configurações de status do pedido garantido.

Representação JSON 
{
  "entityStatus": enum (EntityStatus),
  "entityPauseReason": string,
  "configStatus": enum (GuaranteedOrderConfigStatus)
}
Campos
entityStatus

enum (EntityStatus)

Se o pedido garantido pode ser veiculado ou não.

Os valores aceitáveis são ENTITY_STATUS_ACTIVE, ENTITY_STATUS_ARCHIVED e ENTITY_STATUS_PAUSED. O valor padrão é ENTITY_STATUS_ACTIVE.
entityPauseReason

string

O motivo fornecido pelo usuário para pausar este pedido garantido.

Precisa ser codificado em UTF-8 com comprimento máximo de 100 bytes.

Aplicável apenas quando entityStatus está definido como ENTITY_STATUS_PAUSED.
configStatus

enum (GuaranteedOrderConfigStatus)

Apenas saída. O status de configuração do pedido garantido.

Os valores aceitáveis são PENDING e COMPLETED.

Um pedido garantido precisa ser configurado (preencha os campos obrigatórios, escolha criativos e selecione uma campanha padrão) antes de ser veiculado. No momento, a ação de configuração só pode ser executada na interface.

GuaranteedOrderConfigStatus

Estados de configuração possíveis para um pedido garantido.

Enums
GUARANTEED_ORDER_CONFIG_STATUS_UNSPECIFIED O status de aprovação não foi especificado ou é desconhecido nesta versão.
PENDING O estado inicial de um pedido garantido. O pedido garantido nesse estado precisa ser configurado antes de ser veiculado.
COMPLETED O estado após o comprador configurar um pedido garantido.

Métodos

create

 Cria um novo pedido garantido.

editGuaranteedOrderReadAccessors

 Edita a leitura dos anunciantes de um pedido garantido.

get

 Recebe um pedido garantido.

list

 Lista pedidos garantidos que são acessíveis ao usuário atual.

patch

 Atualiza um pedido garantido existente.