Recurso: GuaranteedOrder
Um pedido garantido.
Os pedidos garantidos são a entidade pai das origens de inventário garantidas. Ao criar uma origem de inventário garantido, um ID de pedido garantido precisa ser atribuído à origem.
Representação JSON |
---|
{ "name": string, "legacyGuaranteedOrderId": string, "exchange": enum ( |
Campos | |
---|---|
name |
Apenas saída. O nome do recurso do pedido garantido. |
legacyGuaranteedOrderId |
Apenas saída. O ID legado do pedido garantido. Atribuída pela troca original. O ID legado é exclusivo em uma troca, mas não é garantido que seja exclusivo em todos os pedidos garantidos. Esse ID é usado no SDF e na interface. |
exchange |
Obrigatório. Imutável. A bolsa em que o pedido garantido foi originado. |
guaranteedOrderId |
Apenas saída. O identificador exclusivo do pedido garantido. Os IDs de pedidos garantidos têm o formato |
displayName |
Obrigatório. O nome de exibição do pedido garantido. Precisa ser codificado em UTF-8 com um tamanho máximo de 240 bytes. |
status |
As configurações de status do pedido garantido. |
updateTime |
Apenas saída. O carimbo de data/hora da última atualização do pedido garantido. Atribuído pelo sistema. Usa o RFC 3339, em que a saída gerada é sempre normalizada em Z e usa 0, 3, 6 ou 9 dígitos fracionários. Deslocamentos diferentes de "Z" também são aceitos. Exemplos: |
publisherName |
Obrigatório. O nome do editor do pedido garantido. Precisa ser codificado em UTF-8 com um tamanho máximo de 240 bytes. |
readAccessInherited |
Se todos os anunciantes de |
readAdvertiserIds[] |
Os IDs dos anunciantes com acesso de leitura ao pedido garantido. Esse campo não pode incluir o anunciante atribuído a |
defaultAdvertiserId |
Apenas saída. O ID do anunciante padrão do pedido garantido. O anunciante padrão é o |
defaultCampaignId |
O ID da campanha padrão atribuída ao pedido garantido. A campanha padrão precisa pertencer ao anunciante padrão. |
Campo de união O parceiro ou anunciante com acesso de leitura/gravação ao pedido garantido. |
|
readWritePartnerId |
O parceiro com acesso de leitura/gravação ao pedido garantido. |
readWriteAdvertiserId |
O anunciante com acesso de leitura/gravação ao pedido garantido. Esse também é o anunciante padrão do pedido garantido. |
GuaranteedOrderStatus
As configurações de status do pedido garantido.
Representação JSON |
---|
{ "entityStatus": enum ( |
Campos | |
---|---|
entityStatus |
Indica se o pedido garantido pode ser atendido ou não. Os valores aceitáveis são |
entityPauseReason |
O motivo fornecido pelo usuário para pausar o pedido garantido. Precisa ser codificado em UTF-8 com um comprimento máximo de 100 bytes. Aplicável somente quando |
configStatus |
Apenas saída. O status de configuração do pedido garantido. Os valores aceitáveis são 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 realizada pela interface. |
GuaranteedOrderConfigStatus
Possíveis estados de configuração de 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 depois que o comprador configura um pedido garantido. |
Métodos |
|
---|---|
|
Cria um novo pedido garantido. |
|
Edita os anunciantes lidos de um pedido garantido. |
|
Recebe um pedido garantido. |
|
Lista os pedidos garantidos acessíveis ao usuário atual. |
|
Atualiza um pedido garantido. |