Método: ampUrls.batchGet

Retorna URLs de AMP e URLs do cache de AMP equivalentes.

Solicitação HTTP

POST https://acceleratedmobilepageurl.googleapis.com/v1/ampUrls:batchGet

O URL usa a sintaxe de anotação HTTP da API do Google.

Corpo da solicitação

O corpo da solicitação contém dados com a seguinte estrutura:

Representação JSON
{
  "urls": [
    string
  ]
  "lookupStrategy": enum(LookupStrategy),
}
Campos
urls[]

string

Lista de URLs para pesquisar os URLs pareados de AMP. Os URLs diferenciam maiúsculas de minúsculas. Até 50 URLs por pesquisa (consulte Limites de uso).

lookupStrategy

enum(LookupStrategy)

O lookupStrategy que está sendo solicitado.

Corpo da resposta

Se bem-sucedido, o corpo da resposta incluirá dados com a estrutura a seguir:

Resposta do URL de AMP em lote.

Representação JSON
{
  "ampUrls": [
    {
      object(AmpUrl)
    }
  ],
  "urlErrors": [
    {
      object(AmpUrlError)
    }
  ],
}
Campos
ampUrls[]

object(AmpUrl)

Para cada URL em BatchAmpUrlsRequest, a resposta do URL. A resposta pode não estar na mesma ordem que os URLs na solicitação em lote. Se BatchAmpUrlsRequest contiver URLs duplicados, o AmpUrl será gerado apenas uma vez.

urlErrors[]

object(AmpUrlError)

Os erros dos URLs solicitados que não possuem URL de AMP.

LookupStrategy

Enumerações
FETCH_LIVE_DOC A estratégia FETCH_LIVE_DOC envolve a busca de documentos ativos de URLs não encontrados no índice. Todo URL de solicitação não encontrado no índice é rastreado em tempo real para validar se há um URL de AMP correspondente. Essa estratégia tem uma cobertura maior, mas com latência extra introduzida pelo rastreamento em tempo real. Essa é a estratégia padrão. Aplicativos que usam essa estratégia precisam definir tempos limite de HTTP mais altos para as chamadas de API.
IN_INDEX_DOC A estratégia IN_INDEX_DOC ignora a busca de documentos ativos de URLs não encontrados no índice. Para aplicativos que precisam de baixa latência, é recomendável usar a estratégia IN_INDEX_DOC.

AmpUrl

Resposta do URL de AMP para um URL solicitado.

Representação JSON
{
  "originalUrl": string,
  "ampUrl": string,
  "cdnAmpUrl": string,
}
Campos
originalUrl

string

O URL original não AMP.

ampUrl

string

O URL de AMP que aponta para o servidor da Web do editor.

cdnAmpUrl

string

O URL do cache de AMP que aponta para o documento armazenado no Google AMP Cache.

AmpUrlError

Recurso de erro do URL de AMP para um URL solicitado que não foi encontrado.

Representação JSON
{
  "errorCode": enum(ErrorCode),
  "errorMessage": string,
  "originalUrl": string,
}
Campos
errorCode

enum(ErrorCode)

O código de erro de uma chamada de API.

errorMessage

string

Uma mensagem de erro descritiva opcional.

originalUrl

string

O URL original não AMP.

ErrorCode

Códigos de erro para uma pesquisa do URL de AMP em lote.

Enumerações
ERROR_CODE_UNSPECIFIED Erro não especificado.
INPUT_URL_NOT_FOUND Indica que o URL solicitado não foi encontrado no índice, possivelmente porque não pode ser acessado pelo Googlebot ou algum outro erro.
NO_AMP_URL Indica que não foi encontrado nenhum URL de AMP correspondente ao URL solicitado.
APPLICATION_ERROR Indica que algum tipo de erro de aplicativo ocorreu no servidor. É aconselhável que o cliente tente mais uma vez.
URL_IS_VALID_AMP OBSOLETO: indica que o URL solicitado é um URL de AMP válido. Este é um estado de não erro e não será considerado como um sinal de sucesso ou falha. Ele será removido em versões futuras da API.
URL_IS_INVALID_AMP Indica que foi encontrado um URL de AMP que corresponde ao URL solicitado, mas ele não é um HTML para AMP válido.

Testar