Erros e avisos

Esta página discute os diferentes tipos de erros e avisos que você pode encontrar ao usar as funções da API 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 levadas ao a serem consideradas ao analisar as solicitações de cota adicional. Respostas de erro devem ser processados e processados 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 do código RPC do Google:

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

Confira abaixo uma lista de erros comuns de API e as ações recomendadas se forem retornados:

Código RPC Ação recomendada
400 INVALID_ARGUMENT Ocorreu um problema com sua solicitação. Analise o na resposta de erro e modificar sua solicitação de acordo.
401 UNAUTHENTICATED Sua solicitação não foi autenticada corretamente. Verifique se você inseriu informações credenciais na solicitação. Para mais informações sobre isso, consulte nossa Guia explicativo.
403 PERMISSION_DENIED Você não tem as permissões necessárias para concluir sua solicitação. Verifique se sua conta de usuário tem as permissões apropriadas do parceiro ou anunciante.
404 NOT_FOUND O recurso que você está tentando recuperar não pode ser encontrado. Verifique se o documento de identificação que você está usando é correto e para o tipo de recurso que está sendo recuperado.
409 ABORTED O recurso que você está tentando modificar está sendo modificados em outro lugar. Aguarde alguns segundos e repetir a solicitação.
429 RESOURCE_EXHAUSTED Você excedeu seu limite de taxa ou cota de solicitação diária. Examine o uso da API com o Console de APIs do Google e modifique seu para operar dentro da cota existente limites. Para mais informações, consulte nossa página sobre Otimização de cotas.

Se não for possível concluir as operações dentro do com uma cota diária, é possível solicitar cota adicional.
500 INTERNAL Ocorreu um erro interno na API. Espere um pouco segundos e repetir a solicitação. 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 fazer a solicitação novamente. Se o erro persiste, entre em contato com o suporte.

Erros de SDF

As campanhas A API Video 360 usa um método assíncrono para Como gerar e fazer o download de arquivos de dados estruturados (SDFs, na sigla em inglês). Para isso Os erros gerados durante a geração do SDF são retornados no SDF finalizado. download. Uma tarefa de download de SDF terminada em error está marcado como concluído, mas tem um campo de erro preenchido em vez de um nome de recurso de mídia no campo response, como 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, deve segui-la de acordo. Se a mensagem de erro não for claramente acionável, nós recomendamos as seguintes ações:

  • Verifique se o usuário tem as permissões adequadas para a conta mãe recursos de parceiro ou anunciante.
  • Confirme se os IDs fornecidos no filtro estão corretos. correspondem ao tipo de recurso pretendido e estão no contexto da root id fornecido.
  • Verifique se você não está excedendo o limite de 20 downloads simultâneos de SDFs tarefas por usuário.

Se os erros continuarem ocorrendo, entre em contato com o suporte para informar o problema.

Avisos sem bloqueio

Avisos sem bloqueio são atribuídos aos itens de linha para indicar uma um problema que pode afetar a veiculação de um item de linha. Avisos semelhantes são comunicados na interface por um banner de notificação. Esses avisos são passivos listado 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 evitá-lo completamente.

Prevenção

Muitos problemas que causam avisos sem bloqueio podem ser evitados com da configuração do item de linha, incluindo o seguinte:

  • Período de veiculação: se o período de um item de linha for inválido ou se o o período de veiculação do pedido de inserção pai expirar, o item de linha gerará um e não será veiculado. Para evitar o último problema, certifique-se de que uma linha o período de veiculação do item não termina depois do período da inserção pai ordem.
  • Criativos atribuídos: se não houver um criativo válido atribuído a um item de linha, ele vai gerar um aviso atender.
  • Segmentação: se a segmentação de um item de linha não estiver atribuído corretamente, o item de linha poderá gerar um aviso, e a veiculação poderá ser impactados ou evitados.

Se você estiver replicando configurações de um item de linha existente, verifique se o item de linha existente não gera avisos imprevistos.

Monitoramento

Problemas que causam avisos sem bloqueio podem surgir enquanto um item de linha está no voo Para garantir que seus itens de linha sejam veiculados corretamente, monitore seus itens de linha ativos para avisos gerados recentemente. Os itens de linha podem ser recuperados em massa usando a função advertisers.lineItems.list. Se um item de linha gerar um aviso inesperado, você deverá resolver o problema imediatamente para reduzir o impacto na veiculação.

Os problemas podem surgir mesmo que as configurações ou a segmentação de um item de linha não tenham sido alteradas. Os exemplos incluem a pausa ou expiração do pedido de inserção pai e as a descontinuação das listas de usuários ou outras segmentações.