AMP URL API를 사용하여 URL을 해당하는 AMP URL에 매칭하고 대신 AMP 버전을 제공하세요.
AMP URL에 URL 일치
다음을 통해 AMP URL을 요청하세요.
POST https://acceleratedmobilepageurl.googleapis.com/v1/ampUrls:batchGet
요청 본문에 페이로드로 최대 50개의 URL을 나열합니다.
{"urls": [
"https://www.amp.dev",
"https://www.example.org/article-without-amp-version"
]}
모든 요청에는 X-승인 헤더(X-Goog-Api-Key: YOUR-DEVELOPER-KEY)를 통해 개발 키를 포함해야 합니다. X-승인 헤더 값은 대소문자를 구분합니다.
개발 키가 없는 경우 승인에서 설정 안내를 참조하세요.
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을 AMP URL로 대체
batchGet 메서드는
AMP URL 매핑을 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"
}
]
}
원래 AMP URL과 Google AMP Cache에 저장된 URL이 모두 응답 본문에 반환됩니다.
애플리케이션에서 Google AMP Cache의 이점을 모두 활용할 수 있도록 "ampUrl" 대신 "cdnAmpUrl"을 사용하는 것이 좋습니다.
리디렉션 설정
서버에서 AMP 파일의 위치를 이동할 때마다 이전 위치에서 새 위치로 리디렉션을 설정합니다. Google AMP Cache는 리디렉션을 따라 AMP URL을 확인합니다.
URL이 다른 유효한 AMP URL로 리디렉션되는 경우 Google AMP Cache는 확인된 리디렉션의 콘텐츠를 반환하고 캐시합니다.