Method: ampUrls.batchGet

Restituisce gli URL AMP e gli URL AMP Cache equivalenti.

Richiesta HTTP

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

L'URL utilizza la sintassi di annotazione HTTP dell'API di Google.

Corpo della richiesta

Il corpo della richiesta contiene i dati con la seguente struttura:

Rappresentazione JSON 
{
  "urls": [
    string
  ]
  "lookupStrategy": enum(LookupStrategy),
}
Campi
urls[]

string

Elenco di URL da cercare per gli URL AMP accoppiati. Gli URL sono sensibili alle maiuscole. Fino a 50 URL per ricerca (vedi Limiti di utilizzo).

lookupStrategy

enum(LookupStrategy)

La richiesta di ricerca richiesta.

Corpo della risposta

In caso di esito positivo, il corpo della risposta contiene dati con la seguente struttura:

Risposta batch URL AMP.

Rappresentazione JSON 
{
  "ampUrls": [
    {
      object(AmpUrl)
    }
  ],
  "urlErrors": [
    {
      object(AmpUrlError)
    }
  ],
}
Campi
ampUrls[]

object(AmpUrl)

Per ogni URL in BatchAmpUrlsRequest, la risposta dell'URL. La risposta potrebbe non seguire lo stesso ordine degli URL nella richiesta in batch. Se BatchAmpUrlsRequest contiene URL duplicati, AmpUrl viene generato solo una volta.

urlErrors[]

object(AmpUrlError)

Gli errori per gli URL richiesti che non hanno un URL AMP.

Strategia di ricerca

Enum
FETCH_LIVE_DOC La strategia FETCH_LIVE_DOC prevede il recupero in tempo reale dei documenti degli URL non trovati nell'indice. Qualsiasi URL di richiesta non trovato nell'indice viene sottoposto a scansione in tempo reale per verificare se è presente un URL AMP corrispondente. Questa strategia ha una copertura più elevata, ma con una latenza aggiuntiva introdotta dalla scansione in tempo reale. Questa è la strategia predefinita. Le applicazioni che utilizzano questa strategia dovrebbero impostare timeout HTTP più elevati delle chiamate API.
IN_INDEX_DOC La strategia IN_INDEX_DOC ignora il recupero dei documenti pubblicati di URL non trovati nell'indice. Per le applicazioni che richiedono una bassa latenza, si consiglia l'uso della strategia IN_INDEX_DOC.

URLAmp

Risposta URL AMP per un URL richiesto.

Rappresentazione JSON 
{
  "originalUrl": string,
  "ampUrl": string,
  "cdnAmpUrl": string,
}
Campi
originalUrl

string

L'URL non AMP originale.

ampUrl

string

L'URL AMP che rimanda al server web del publisher.

cdnAmpUrl

string

L'URL AMP Cache che rimanda al documento memorizzato nella cache in Google AMP Cache.

Errore AmpUrl

Risorsa di errore URL AMP per un URL richiesto che non è stato possibile trovare.

Rappresentazione JSON 
{
  "errorCode": enum(ErrorCode),
  "errorMessage": string,
  "originalUrl": string,
}
Campi
errorCode

enum(ErrorCode)

Il codice di errore di una chiamata API.

errorMessage

string

Un messaggio di errore descrittivo facoltativo.

originalUrl

string

L'URL non AMP originale.

ErrorCode

Codici di errore per una ricerca batch di URL AMP.

Enum
ERROR_CODE_UNSPECIFIED Errore non specificato.
INPUT_URL_NOT_FOUND Indica che l'URL richiesto non è stato trovato nell'indice, probabilmente perché non è stato trovato, non è accessibile a Googlebot o perché esiste un altro errore.
NO_AMP_URL Indica che non è stato trovato alcun URL AMP corrispondente all'URL richiesto.
APPLICATION_ERROR Indica un qualche tipo di errore dell'applicazione sul server. Il client consiglia di riprovare.
URL_IS_VALID_AMP OBSOLETO: indica che l'URL richiesto è un URL AMP valido. Questo è uno stato non di errore, su cui non si deve fare affidamento come segno di successo o errore. Verrà rimosso nelle versioni future dell'API.
URL_IS_INVALID_AMP Indica che è stato trovato un URL AMP che corrisponde all'URL della richiesta, ma non è un codice HTML AMP valido.

Prova.