AMP 콘텐츠 링크

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는 확인된 리디렉션의 콘텐츠를 반환하고 캐시합니다.