Erros e avisos

Esta página discute os diferentes tipos de erros e avisos que você pode encontrar ao usar a API Display & Video 360.

Erros da API

As solicitações feitas à API que não podem ser concluídas retornam uma mensagem de erro. As solicitações que retornam erros são contabilizadas na cota do usuário e serão consideradas na análise das solicitações de cota adicional. As respostas com erro precisam ser processadas e tratadas para evitar erros futuros.

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

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

Veja abaixo uma lista de erros comuns de API e a ação recomendada a ser realizada se eles forem retornados:

Código RPC Ação recomendada
400 INVALID_ARGUMENT Ocorreu um problema com sua solicitação. Revise o campo de mensagem na resposta de erro e modifique sua solicitação.
401 UNAUTHENTICATED Sua solicitação não foi autenticada corretamente. Verifique se você está incluindo credenciais OAuth válidas na solicitação. Para mais informações, consulte nosso Guia explicativo.
403 PERMISSION_DENIED Você não tem as permissões necessárias para concluir a solicitação. Verifique se a conta de usuário tem as permissões adequadas para o parceiro ou anunciante relevante.
404 NOT_FOUND O recurso que você está tentando recuperar não pode ser encontrado. Verifique se o ID que você está usando está correto e se o 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 enviar a solicitação novamente.
429 RESOURCE_EXHAUSTED Você excedeu seu limite de taxa ou cota de solicitação diária. Analise o uso da API com o Console de APIs do Google e modifique o fluxo de trabalho para operar dentro dos limites de cota atuais. Para mais informações, consulte nossa página sobre Otimização de cotas.

Se as operações não puderem ser concluídas dentro da cota diária, você poderá solicitar uma cota adicional.
500 INTERNAL Ocorreu um erro interno na API. Aguarde alguns segundos e tente enviar a solicitação novamente. Se o erro permanecer, 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 um método assíncrono para gerar e fazer o download de arquivos de dados estruturados (SDFs, na sigla em inglês). Por isso, os erros gerados durante a geração do SDF são retornados na tarefa de download do SDF concluída. Uma tarefa de download de SDF que termina em error é marcada como concluída, mas tem um campo de erro preenchido em vez de um nome de recurso de mídia no campo response, como mostrado neste exemplo truncado:

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

Se você receber uma mensagem de erro acionável ao tentar gerar SDFs, siga-a corretamente. Se a mensagem de erro não for claramente acionável, recomendamos as seguintes ações:

  • Verifique se o usuário tem as permissões adequadas para os recursos pais de parceiro ou anunciante.
  • Confirme se os IDs fornecidos no filtro são precisos, correspondem ao tipo de recurso pretendido e estão no contexto do ID raiz fornecido.
  • Verifique se você não está excedendo o limite de 20 tarefas de download de SDF simultâneas por usuário.

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

Avisos sem bloqueio

Avisos sem bloqueio são atribuídos a itens de linha para indicar um problema que pode afetar a veiculação de um item de linha. Avisos semelhantes são comunicados na IU por um banner de notificação. Esses avisos são passivos e são listados no campo warningMessages de um item de linha.

Embora passivos, os problemas que causam esses avisos podem afetar a veiculação de um item de linha a ponto de impedir completamente a exibição dele.

Prevenção

Muitos problemas que geram avisos sem bloqueio podem ser evitados com a configuração adequada das definições de itens de linha, incluindo o seguinte:

  • Período de veiculação: se o período de veiculação de um item de linha for inválido ou se o período de veiculação do pedido de inserção pai expirar, o item de linha vai gerar um aviso e não será veiculado. Para evitar o último problema, verifique se o período de veiculação de um item de linha não termina após o período de veiculação do pedido de inserção pai.
  • Criativos atribuídos: se não houver um criativo válido atribuído a um item de linha, o item de linha vai gerar um aviso e não ser veiculado.
  • Segmentação: se a segmentação de um item de linha não for atribuída corretamente, o item de linha poderá gerar um aviso, e a veiculação poderá ser impactada ou totalmente impedida.

Se você estiver replicando configurações de um item de linha atual, verifique se ele não está gerando avisos imprevistos.

Monitoramento

Problemas que causam avisos sem bloqueio podem surgir enquanto um item de linha está em andamento. Para garantir que seus itens de linha sejam veiculados corretamente, monitore seus itens de linha ativos em busca de avisos recém-gerados. Os itens de linha podem ser recuperados em massa usando a função advertisers.lineItems.list. Se um item de linha estiver gerando um aviso inesperado, resolva o problema imediatamente para reduzir o impacto na veiculação.

Podem surgir problemas mesmo que as configurações ou a segmentação de um item de linha não tenham sido alteradas. Por exemplo, a pausa ou expiração do pedido de inserção pai e a descontinuação de listas de usuários ou outra segmentação.