seowatcher guia

Chave do PageSpeed

Obtenha uma chave gratuita do Google PageSpeed para medir a velocidade das páginas e informe-a no aplicativo. Sem chave, a medição fica limitada a 50 páginas.

Ao fim desta página, a sua chave gratuita do PageSpeed estará obtida, informada no aplicativo e testada. Leva cinco minutos. A opção "Sayfa hızını da ölç" (Medir também a velocidade das páginas), na auditoria do site, mede cada página no celular e no computador com o serviço PageSpeed Insights do Google. O Google oferece esse serviço também sem chave, mas a cota é muito pequena. Depois de poucas páginas ele responde "429, muitas solicitações". Sem chave, o aplicativo limita a medição a no máximo 50 páginas por auditoria. Uma chave gratuita remove esse limite.

O que você precisa

Passos

  1. Em console.cloud.google.com, selecione o seu projeto.
  2. Abra a página API'ler ve Hizmetler → Kitaplık (APIs e serviços → Biblioteca). Procure PageSpeed Insights API e escolha Etkinleştir (Ativar). Se você pular este passo, a chave existe, mas todas as solicitações são recusadas com 403.
  3. Escolha API'ler ve Hizmetler → Kimlik bilgileri → Kimlik bilgisi oluştur → API anahtarı (APIs e serviços → Credenciais → Criar credenciais → Chave de API). Aparece uma chave que começa com "AIza". Copie-a.
  4. Opcional, mas recomendado: escolha Anahtarı kısıtla (Restringir a chave). Na restrição de API, selecione somente a PageSpeed Insights API. Se o seu assistente de IA também for consultar o histórico de dados de usuários reais (CrUX), adicione também a Chrome UX Report API.
  5. No aplicativo, abra Ayarlar → Hız ölçümü (Configurações → Medição de velocidade). Cole a chave no campo API anahtarı (Chave de API). Escolha Kaydet (Salvar). Aparece o aviso "PageSpeed anahtarı kaydedildi" (Chave do PageSpeed salva). Não é preciso reiniciar.
  6. Na mesma seção, clique no botão Anahtarı test et (Testar a chave). O aplicativo faz uma medição real para example.com (usa 1 medição). A resposta esperada é "Anahtar çalışıyor: Google PageSpeed Insights ölçümü kabul etti." (A chave funciona: o Google PageSpeed Insights aceitou a medição.)

Se você usa Docker, também pode informar a chave no arquivo .env como PAGESPEED_API_KEY. A tela Ayarlar é mais fácil, e o valor informado nela tem prioridade.

Verificação

Perguntas frequentes

Qual é o tamanho da cota? O Google não dá um número oficial e o muda com o tempo. O valor real aparece no Cloud Console, em API'ler ve Hizmetler → Kotalar (APIs e serviços → Cotas). Na prática, há um limite por minuto e um limite por dia. Cada página usa duas medições: celular e computador.

O que acontece se eu atingir o limite por minuto? O aplicativo espera e tenta de novo. A auditoria fica mais lenta, mas você não precisa fazer nada. Se o limite diário acabar, a medição para. Os resultados até aquele ponto ficam guardados. O restante é concluído em uma nova auditoria no dia seguinte.

E se duas auditorias medirem a velocidade ao mesmo tempo? Elas dividem o limite por minuto, e cada uma leva o dobro do tempo. A medição de velocidade de um site com 212 páginas leva cerca de 24 minutos sozinha e 48 minutos junto com outra auditoria; com o rastreamento, a auditoria inteira chega a 35 minutos.

Onde a chave fica guardada? No banco de dados deste computador, criptografada. Ela não é devolvida ao navegador. A tela Ayarlar mostra apenas a informação "salva".

Sem chave não se mede nada? Mede-se, até 50 páginas. Muitas vezes parte delas falha com 429. Para um site pequeno, pode bastar. Para sites com mais de 50 páginas, é preciso uma chave.

Se algo der errado

Última atualização: 23 de outubro de 2026. Viu algum erro? Relate no GitHub.