Interfejs AMP URL API służy do dopasowywania adresów URL do odpowiednich adresów URL AMP i wyświetlania wersji AMP zamiast standardowych.
Dopasowywanie adresów URL do adresów URL AMP
Prześlij żądanie adresu URL AMP:
POST https://acceleratedmobilepageurl.googleapis.com/v1/ampUrls:batchGet
Wymień maksymalnie 50 adresów URL jako ładunek w treści żądania:
{"urls": [
"https://www.amp.dev",
"https://www.example.org/article-without-amp-version"
]}
Wszystkie żądania muszą zawierać klucz programisty w nagłówku X-Authorization (X-Goog-Api-Key: YOUR-DEVELOPER-KEY). W wartości nagłówka X-Authorization jest rozróżniana wielkość liter.
Jeśli nie masz klucza programisty, instrukcje konfiguracji znajdziesz w rozdziale Autoryzacja.
Przykład z wykorzystaniem curl:
curl -i -s -k -X POST -H "Content-Type: application/json" -H "X-Goog-Api-Key:" -d "{urls: ['https://example.com']}" "https://acceleratedmobilepageurl.googleapis.com/v1/ampUrls:batchGet"
Zastępowanie adresów URL adresami URL AMP
Metoda batchGet zwraca mapowanie adresu URL AMP w formacie JSON:
{
"ampUrls": [
{
"originalUrl": "https://example.com",
"ampUrl": "https://example.com",
"cdnAmpUrl":
"https://cdn.ampproject.org/c/s/example.com"
}
],
"urlErrors": [
{
"errorCode": "NO_AMP_URL",
"errorMessage": "AMP URL not found.",
"originalUrl": "http://www.example.com/no-amp-version.html"
}
]
}
Zarówno pierwotny adres URL AMP, jak i ten zapisany w Google AMP Cache, są zwracane w treści odpowiedzi.
Zachęcamy do używania "cdnAmpUrl" zamiast "ampUrl", by aplikacja mogła wykorzystać wszystkie możliwości Google AMP Cache.
Konfigurowanie przekierowań
Po każdym przeniesieniu plików AMP na serwerze skonfiguruj przekierowania ze starych do nowych lokalizacji. Google AMP Cache śledzi przekierowania, analizując adresy URL AMP.
Jeśli adres URL przekierowuje pod inny prawidłowy adres URL AMP, Google AMP Cache zwraca treści wskazywane przez przekierowanie i zapisuje je w pamięci podręcznej.