Метод: ampUrls.batchGet

Позволяет получить URL для AMP и соответствующие URL контента в AMP Cache.

HTTP-запрос

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

В URL используется синтаксис для аннотаций Google API HTTP.

Тело запроса

Ниже приведена структура данных в теле запроса.

JSON-представление
{
  "urls": [
    string
  ]
  "lookupStrategy": enum(LookupStrategy),
}
Поля
urls[]

string

Список URL, которые требуется соотнести с URL для AMP. Регистр символов имеет значение. Можно соотносить до 50 URL за один раз (см. ограничения на использование).

lookupStrategy

enum(LookupStrategy)

Стратегия lookupStrategy, которую нужно применить в запросе.

Тело ответа

Ниже представлена структура данных в теле ответа после успешного выполнения запроса.

Ответ на массовый запрос URL для AMP.

JSON-представление
{
  "ampUrls": [
    {
      object(AmpUrl)
    }
  ],
  "urlErrors": [
    {
      object(AmpUrlError)
    }
  ],
}
Поля
ampUrls[]

object(AmpUrl)

Ответ в виде URL по каждому URL из запроса BatchAmpUrlsRequest. Порядок URL в ответе может не совпадать с их порядком в массовом запросе. Если BatchAmpUrlsRequest содержит повторяющиеся URL, ответ генерируется только для одного из них.

urlErrors[]

object(AmpUrlError)

Ошибки, которые означают, что у определенных URL из запроса нет соответствующих URL для AMP.

LookupStrategy

Перечисления
FETCH_LIVE_DOC При использовании стратегии FETCH_LIVE_DOC по URL, не найденным в индексе, загружаются доступные документы. Каждый не обнаруженный в индексе URL из запроса сканируется в режиме реального времени с целью проверить, есть ли у него соответствующий URL для AMP. Такой метод позволяет увеличить покрытие, но приводит к росту задержек. Эта стратегия выбрана по умолчанию. Для приложений, в которых она используется, следует задать более долгое время ожидания HTTP-ответа на вызовы API.
IN_INDEX_DOC Стратегия IN_INDEX_DOC не предполагает загрузки доступных документов по URL, не найденным в индексе. Эта стратегия предпочтительна, если важно минимизировать задержку.

AmpUrl

Ответ по URL из запроса в виде URL для AMP.

JSON-представление
{
  "originalUrl": string,
  "ampUrl": string,
  "cdnAmpUrl": string,
}
Поля
originalUrl

string

Исходный обычный URL.

ampUrl

string

URL для AMP, указывающий на веб-сервер издателя.

cdnAmpUrl

string

URL кешированной версии документа в Google AMP Cache.

AmpUrlError

Ресурс, сигнализирующий, что для определенного URL из запроса не было найдено URL AMP-контента.

JSON-представление
{
  "errorCode": enum(ErrorCode),
  "errorMessage": string,
  "originalUrl": string,
}
Поля
errorCode

enum(ErrorCode)

Код ошибки вызова API.

errorMessage

string

Сообщение об ошибке с ее описанием (необязательно).

originalUrl

string

Исходный обычный URL.

ErrorCode

Коды ошибок, возникающих при массовом поиске URL для AMP.

Перечисления
ERROR_CODE_UNSPECIFIED Неизвестная ошибка.
INPUT_URL_NOT_FOUND URL из запроса по той или иной причине не найден в индексе, например потому что недоступен роботу Googlebot.
NO_AMP_URL У определенного URL из запроса не обнаружено соответствий в виде URL для AMP.
APPLICATION_ERROR Произошла ошибка приложения на сервере. Клиенту было рекомендовано повторить попытку.
URL_IS_VALID_AMP ПОДДЕРЖКА ПРЕКРАЩЕНА. URL из запроса является действительным URL для AMP. Эта ситуация не является ошибкой сама по себе. В новых версиях API этого статуса не будет.
URL_IS_INVALID_AMP URL из запроса соотнесен с URL для AMP, но найденный документ не отвечает требованиям к HTML с технологией AMP.

Попробовать