Method: ampUrls.batchGet

Muestra las URL de AMP y las URL almacenadas en caché de AMP equivalentes.

Solicitud HTTP

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

La URL usa la sintaxis de anotación HTTP de la API de Google.

Cuerpo de la solicitud

El cuerpo de la solicitud contiene datos con la siguiente estructura:

Representación JSON 
{
  "urls": [
    string
  ]
  "lookupStrategy": enum(LookupStrategy),
}
Campos
urls[]

string

Lista de URLs para buscar las URLs de AMP sincronizadas. Las URLs distinguen mayúsculas de minúsculas. Se permiten hasta 50 URL por búsqueda (consulta Límites de uso).

lookupStrategy

enum(LookupStrategy)

Es el objeto lookupStrategy que se solicita.

Cuerpo de la respuesta

Si se ejecuta correctamente, el cuerpo de la respuesta contendrá datos con la siguiente estructura:

Respuesta por lotes de URL de AMP.

Representación JSON 
{
  "ampUrls": [
    {
      object(AmpUrl)
    }
  ],
  "urlErrors": [
    {
      object(AmpUrlError)
    }
  ],
}
Campos
ampUrls[]

object(AmpUrl)

Es la respuesta para cada URL de BatchAmpUrlsRequest. Es posible que la respuesta no esté en el mismo orden que las URL de la solicitud por lotes. Si BatchAmpUrlsRequest incluye URL duplicadas, se generará el objeto AmpUrl solo una vez.

urlErrors[]

object(AmpUrlError)

Son errores de URL solicitadas que no tienen URL de AMP.

LookupStrategy

Enumeraciones
FETCH_LIVE_DOC La estrategia FETCH_LIVE_DOC incluye la búsqueda de documentos en tiempo real de URL que no se encontraron en el índice. En caso de que haya alguna solicitud de URL que no esté en el índice, se rastreará en tiempo real para validar si hay una URL de AMP correspondiente. Esta estrategia, que es la predeterminada, tiene mayor cobertura, pero el rastreo en tiempo real genera latencia adicional. Es la estrategia predeterminada. Las aplicaciones que usan esta estrategia deberían establecer tiempos de espera de HTTP mayores para las llamadas a la API.
IN_INDEX_DOC La estrategia de IN_INDEX_DOC omite la actualización en tiempo real de documentos de URL que no se encuentren en el índice. En el caso de aplicaciones que requieren baja latencia, se recomienda usar la estrategia de IN_INDEX_DOC.

AmpUrl

Respuesta de URL de AMP para una URL solicitada

Representación JSON 
{
  "originalUrl": string,
  "ampUrl": string,
  "cdnAmpUrl": string,
}
Campos
originalUrl

string

Es la URL original que no es de AMP.

ampUrl

string

Es la URL de AMP que dirige al servidor web del publicador.

cdnAmpUrl

string

Es la URL de AMP almacenada en caché que dirige al documento almacenado en la caché de AMP de Google.

AmpUrlError

Corresponde al recurso de error de URL de AMP para una URL solicitada que no se pudo encontrar.

Representación JSON 
{
  "errorCode": enum(ErrorCode),
  "errorMessage": string,
  "originalUrl": string,
}
Campos
errorCode

enum(ErrorCode)

Es el código de error de una llamada a la API.

errorMessage

string

Es un mensaje de error descriptivo opcional.

originalUrl

string

Es la URL original que no es de AMP.

ErrorCode

Corresponde a códigos de error de una búsqueda de URL de AMP por lotes.

Enumeraciones
ERROR_CODE_UNSPECIFIED Error no especificado
INPUT_URL_NOT_FOUND Indica que la URL solicitada no está en el índice, posiblemente porque no se pudo encontrar, porque el robot de Google no pudo acceder a ella o por cualquier otro error.
NO_AMP_URL Indica que no se encontró ninguna URL de AMP que corresponda a la URL solicitada.
APPLICATION_ERROR Indica que hubo algún tipo de error de aplicación en el servidor. Se sugiere que el cliente vuelva a intentarlo.
URL_IS_VALID_AMP OBSOLETO: Indica que la URL solicitada es una URL de AMP válida. Este estado no indica un error y no debería interpretarse como señal de éxito o fracaso. Se quitará en las próximas versiones de la API.
URL_IS_INVALID_AMP Indica que se encontró una URL de AMP que corresponde a la URL solicitada, aunque no es una HTML de AMP válida.

Pruébalo