Как добавлять ссылки на AMP-контент

AMP URL API позволяет сопоставлять стандартные URL с AMP-страницами, чтобы последние отображались вместо обычных страниц.

Как сопоставить обычные URL с URL для AMP

Выполните запрос на получение URL для AMP:

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

Укажите до 50 URL в теле запроса в качестве полезной нагрузки:

{"urls": [
  "https://www.amp.dev",
  "https://www.example.org/article-without-amp-version"
]}

Все запросы должны содержать ключ разработчика в поле заголовка X-Authorization (X-Goog-Api-Key: YOUR-DEVELOPER-KEY). В этом поле нужно учитывать регистр символов. Если у вас нет ключа разработчика, следуйте инструкциям в статье Авторизация запросов.

Пример с использованием команды 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"

Как заменить обычные URL на URL для AMP

Метод batchGet возвращает информацию о сопоставлении URL для AMP в формате 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"
    }
  ]
}

В теле ответа возвращается и исходный URL для AMP, и URL документа в Google AMP Cache. Мы советуем использовать URL из строки "cdnAmpUrl", а не "ampUrl", чтобы приложение поддерживало все возможности Google AMP Cache.

Как настроить переадресацию

Если вы поменяете расположение AMP-файлов на своем сервере, не забудьте настроить перенаправление с прежних адресов на новые. Google AMP Cache открывает целевые страницы переадресации при переходе по URL для AMP.

Если перенаправление осуществляется на другой действительный URL для AMP, то Google AMP Cache показывает результаты и кеширует контент, находящийся по новому адресу.