Gibt AMP-URLs und entsprechende AMP Cache-URLs zurück
HTTP-Anfrage
POST https://acceleratedmobilepageurl.googleapis.com/v1/ampUrls:batchGet
Für die URL wird die Syntax von Google API HTTP-Annotationen verwendet.
Anfragetext
Der Anfragetext enthält Daten mit folgender Struktur:
JSON-Darstellung | |
---|---|
{ "urls": [ string ] "lookupStrategy": enum(LookupStrategy), } |
Felder | |
---|---|
urls[] |
Liste der URLs, die nach den AMP-URL-Paaren durchsucht werden soll. Bei den URLs wird die Groß- und Kleinschreibung berücksichtigt. Bis zu 50 URLs pro Suche sind zulässig (siehe Nutzungsbeschränkungen). |
lookupStrategy |
Die angefragte LookupStrategy. |
Antworttext
Wenn der Vorgang erfolgreich ist, enthält der Antworttext Daten mit folgender Struktur:
Batch-AMP-URL-Antwort
JSON-Darstellung | |
---|---|
{ "ampUrls": [ { object(AmpUrl) } ], "urlErrors": [ { object(AmpUrlError) } ], } |
Felder | |
---|---|
ampUrls[] |
Die URL-Antwort für jede URL in BatchAmpUrlsRequest. Die Antwort befindet sich möglicherweise nicht an derselben Stelle wie die URLs in der Batch-Anfrage. Wenn BatchAmpUrlsRequest doppelte URLs enthält, wird AmpUrl nur einmal generiert. |
urlErrors[] |
Fehler für angefragte URLs ohne AMP-URL. |
LookupStrategy
Aufzählungen | |
---|---|
FETCH_LIVE_DOC |
Bei der Strategie "FETCH_LIVE_DOC" wird das Dokument der URLs, die nicht im Index gefunden werden konnten, live abgerufen. Jede Anfrage-URL, die nicht im Index gefunden wurde, wird in Echtzeit gecrawlt, um zu überprüfen, ob eine entsprechende AMP-URL vorhanden ist. Mit dieser Strategie wird eine höhere Abdeckung erreicht, aber das Echtzeit-Crawlen führt zu zusätzlichen Latenzzeiten. Das ist die Standardstrategie. Für Apps, die diese Strategie verwenden, solltest du höhere HTTP-Zeitlimits für die API-Aufrufe festlegen. |
IN_INDEX_DOC |
Bei der Strategie "IN_INDEX_DOC" werden Dokumente von URLs, die nicht im Index gefunden wurden, nicht live abgerufen. Diese Strategie wird für Apps empfohlen, die eine niedrige Latenz erfordern. |
AmpUrl
AMP-URL-Antwort für eine angefragte URL
JSON-Darstellung | |
---|---|
{ "originalUrl": string, "ampUrl": string, "cdnAmpUrl": string, } |
Felder | |
---|---|
originalUrl |
Die ursprüngliche Nicht-AMP-URL |
ampUrl |
Die AMP-URL, die auf den Webserver des Publishers verweist |
cdnAmpUrl |
Die AMP-Cache-URL, die auf das zwischengespeicherte Dokument im AMP-Cache von Google verweist |
AmpUrlError
AMP-URL-Fehler-Ressource für eine angefragte URL, die nicht gefunden werden konnte
JSON-Darstellung | |
---|---|
{ "errorCode": enum(ErrorCode), "errorMessage": string, "originalUrl": string, } |
Felder | |
---|---|
errorCode |
Der Fehlercode eines API-Aufrufs. |
errorMessage |
Eine optionale, beschreibende Fehlermeldung |
originalUrl |
Die ursprüngliche Nicht-AMP-URL |
Fehlercode
Fehlercodes für eine Batch-AMP-URL-Suche
Aufzählungen | |
---|---|
ERROR_CODE_UNSPECIFIED |
Hierbei handelt es sich um einen nicht näher definierten Fehler. |
INPUT_URL_NOT_FOUND |
Die angefragte URL wurde nicht im Index gefunden. Das kann auch daran liegen, dass sie vom Googlebot nicht aufgerufen werden kann. Eventuell liegt auch ein anderer Fehler vor. |
NO_AMP_URL |
Es wurde keine AMP-URL gefunden, die der angefragten URL entspricht. |
APPLICATION_ERROR |
Auf dem Server ist ein Anwendungsfehler aufgetreten. Der Client sollte die Anfrage noch einmal senden. |
URL_IS_VALID_AMP |
EINGESTELLT: Damit wird angegeben, dass die angefragte URL eine gültige AMP-URL ist. Das ist ein fehlerfreier Zustand und sollte nicht als Hinweis auf einen erfolgreichen oder fehlgeschlagenen Vorgang verstanden werden. Dieser Code wird in zukünftigen Versionen der API entfernt. |
URL_IS_INVALID_AMP |
Es wurde eine AMP-URL gefunden, die der Anfrage-URL entspricht, jedoch kein gültiger AMP-HTML-Code ist. |