Erros e avisos

A API Display & Video 360 pode responder com vários erros e avisos. Uma solução de API íntegra precisa processar esses erros.

Erros da API

As solicitações à API que não realizam a ação pretendida retornam um erro. As respostas de erro precisam ser capturadas e processadas.

Uma resposta de erro da API tem um código de resposta HTTP, uma mensagem de erro e um status de código RPC do Google. Ele tem o seguinte formato:

{
  "error": {
    "code": integer,
    "message": string,
    "status": enum (google.rpc.Code)
  }
}

Confira a seguir uma lista de erros comuns da API e ações recomendadas:

Códigos de erro
`400`	`INVALID_ARGUMENT` Houve um problema com sua solicitação. Revise o campo de mensagem na resposta de erro e atualize sua solicitação de acordo.
`401`	`UNAUTHENTICATED` Não foi possível autenticar sua solicitação corretamente. Verifique se você está incluindo credenciais de OAuth válidas na sua solicitação. Para mais informações, consulte nosso guia de início rápido.
`403`	`PERMISSION_DENIED` Você não tem as permissões necessárias para concluir a solicitação. Verifique se sua conta de usuário tem as permissões adequadas para o parceiro ou anunciante relevante.
`404`	`NOT_FOUND` Não foi possível encontrar o recurso que você está tentando recuperar. Verifique se o ID usado está correto e corresponde ao tipo de recurso que está sendo recuperado.
`409`	`ABORTED` O recurso que você está tentando modificar está sendo modificado em outro lugar. Aguarde alguns segundos e tente de novo.
`429`	`RESOURCE_EXHAUSTED` Você excedeu seu limite de taxa ou cota diária de solicitações. Use o console do Google Cloud para analisar o uso da API. Atualize seu fluxo de trabalho para operar dentro dos limites de cota atuais. Para mais informações, consulte nosso guia sobre Otimização de uso.
`500`	`INTERNAL` A API encontrou um erro interno. Aguarde alguns segundos e tente de novo. Se o erro persistir, entre em contato com o suporte.
`504`	`DEADLINE_EXCEEDED` A API demorou muito para concluir a solicitação. Aguarde alguns segundos e tente de novo. Se o erro persistir, entre em contato com o suporte.

Erros de SDF

A API Display & Video 360 usa tarefas de longa duração para produzir arquivos de dados estruturados (SDFs). Os erros ao criar os SDFs são retornados no operation concluído. O campo error vai conter os detalhes. Confira este exemplo truncado:

{
  ...
  "done": true,
  "error": {
    "code": 3,
    "message": "We couldn't prepare your CSV files: Invalid filter Ids for Advertiser: 00000000"
  }
}

Se a mensagem de erro não estiver clara, recomendamos o seguinte:

Verifique se o usuário tem pelo menos uma função de usuário Padrão para o parceiro ou anunciante principal.
Confirme se os IDs fornecidos no filtro estão corretos. Os IDs precisam corresponder ao tipo de recurso pretendido e ser recursos filhos do ID raiz.
Verifique se o usuário tem menos de 20 tarefas de download simultâneas do SDF.

Se os erros persistirem, entre em contato com o suporte.

Avisos que não causam bloqueio

Os avisos não bloqueadores indicam um problema que pode afetar a veiculação de anúncios de um item de linha. Avisos semelhantes são mostrados na interface. Esses avisos são passivos e listados no item de linha.

A causa principal de um aviso pode afetar a veiculação de um item de linha. Em alguns casos, isso pode impedir totalmente a veiculação de anúncios.

Prevenção

Alguns avisos não bloqueadores são causados pela configuração incorreta de um item de linha:

Período de veiculação: um item de linha não veicula anúncios se o período de veiculação for inválido ou se o período de veiculação do pedido de inserção tiver expirado. Verifique se um item de linha tem um período de veiculação dentro do pedido de inserção.
Criativos atribuídos: um item de linha não pode ser veiculado se um criativo válido não estiver atribuído a ele.
Segmentação: a veiculação de anúncios de um item de linha pode ser afetada ou impedida se a segmentação não for atribuída corretamente.

Verifique se um item de linha atual não está gerando avisos antes de usar as configurações dele em um novo item de linha.

Monitoramento

Avisos não bloqueadores podem aparecer enquanto um item de linha está em exibição. Monitore seus itens de linha ativos para ver novos avisos e garantir que eles estejam sendo veiculados corretamente. Receba itens de linha em massa com uma solicitação list. Se um item de linha retornar um aviso inesperado, resolva o problema o mais rápido possível para reduzir o impacto na veiculação.

Os avisos podem ser adicionados mesmo que as configurações ou a segmentação não tenham mudado. Por exemplo:

O pedido de inserção está pausado ou expira.
Uma lista de usuários ou opção de segmentação foi descontinuada.