Resolução de problemas

Esta página contém informações de resolução de problemas para cada versão das seguintes APIs de infraestrutura de serviços:

  • A API Service Management
  • A API Service Control
  • A API Service Consumer Management

Como posso processar erros da API Service Control em geral?

A API Service Control oferece funcionalidades do plano de controlo, como registo e monitorização, aos serviços geridos. Por conseguinte, os autores das chamadas da API Service Control são normalmente aplicações de servidor. Seguem-se recomendações gerais sobre como processar erros ao nível da API REST/RPC:

  • O seu servidor deve registar todos os erros devolvidos pela API Service Control e pode usar os dados para resolver problemas do seu serviço gerido.
  • Se o seu servidor receber erros 429 da API Service Control, deve devolver erros 429 aos respetivos clientes.
  • Se o seu servidor não conseguir aceder à API Service Control, pode optar por falhar na abertura (ignorar o erro) ou falhar no fecho (devolver 503 ao respetivo cliente).
  • Se o seu servidor receber erros 500 da API Service Control, deve devolver um erro 500 aos respetivos clientes. Normalmente, estes erros significam erros na API Service Control.
  • Se o seu servidor receber outros erros da API Service Control, deve devolver o erro 500 aos respetivos clientes. Normalmente, estes erros significam erros no seu serviço gerido.

O que significa o erro "serviço não ativado"?

Para usar qualquer serviço de API Google, tem de ter um Google Cloud projeto, ativar o serviço para esse projeto e transmitir uma chave da API ou um token de acesso OAuth associado ao projeto para cada pedido de API. Consulte o guia de autorização para ver detalhes. Para corrigir este erro, tem de ativar o serviço para o seu projeto através da Google Cloud consola, da CLI do Google Cloud ou da API Service Usage. Para saber como ativar um serviço, consulte o artigo Ativar e desativar serviços.

Como posso corrigir erros de autorização recusada?

Normalmente, estes erros significam que o autor da chamada não tem a autorização de Identity and Access Management correta em determinados recursos. Para obter informações sobre as autorizações necessárias para cada uma das seguintes APIs de infraestrutura de serviços, consulte a página de controlo de acesso respetiva:

Como posso repetir erros da API?

Recomendamos que faça uma nova tentativa com intervalos exponenciais e aleatoriedade. O intervalo mínimo de novas tentativas deve ser de 30 segundos para erros de quota 429, 1 segundo para erros de servidor 500 e 503. Para outros erros, a nova tentativa só deve ser realizada com base em informações de erro adicionais. Consulte google.rpc.Code para ver mais detalhes.

Como posso pedir uma quota da API mais elevada?

Para saber como se candidatar a uma quota mais elevada para cada uma das seguintes APIs de infraestrutura de serviços, visite a secção respetiva da página Quotas e limites:

Como posso corrigir os erros "Não é possível validar a propriedade do nome de domínio"?

Este erro indica que o autor da chamada não tem a propriedade do nome do domínio usado para o nome do serviço gerido especificado numa configuração do serviço. Siga o guia para usar um domínio válido.