Method: ampUrls.batchGet

AMP URL 및 이에 상응하는 AMP 캐시 URL을 반환합니다.

HTTP 요청

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

URL은 Google API HTTP 주석 구문을 사용합니다.

요청 본문

요청 본문에는 다음과 같은 구조의 데이터가 포함됩니다.

JSON 표현
{
  "urls": [
    string
  ]
  "lookupStrategy": enum(LookupStrategy),
}
필드
urls[]

string

페어링된 AMP URL을 조회할 URL 목록입니다. URL은 대소문자를 구분합니다. 조회당 최대 50개의 URL (사용량 한도 참고)

lookupStrategy

enum(LookupStrategy)

요청 중인 lookupStrategy입니다.

응답 본문

성공할 경우 응답 본문에 다음 구조의 데이터가 포함됩니다.

일괄 AMP URL 응답입니다.

JSON 표현
{
  "ampUrls": [
    {
      object(AmpUrl)
    }
  ],
  "urlErrors": [
    {
      object(AmpUrlError)
    }
  ],
}
필드
ampUrls[]

object(AmpUrl)

BatchAmpUrlsRequest의 각 URL에 대한 URL 응답입니다. 응답은 일괄 요청의 URL 순서와 같지 않을 수 있습니다. BatchAmpUrlsRequest에 중복 URL이 포함된 경우 AmpUrl은 한 번만 생성됩니다.

urlErrors[]

object(AmpUrlError)

요청한 URL 중 AMP URL이 없는 오류입니다.

조회 전략

열거형
FETCH_LIVE_DOC FETCH_LIVE_DOC 전략에는 색인에서 찾을 수 없는 URL의 실시간 문서 가져오기가 포함됩니다. 색인에서 찾을 수 없는 요청 URL은 상응하는 AMP URL이 있는지 확인하기 위해 실시간으로 크롤링됩니다. 이 전략은 적용 범위가 넓지만 실시간 크롤링을 통해 지연 시간이 추가되었습니다. 기본 전략입니다. 이 전략을 사용하는 애플리케이션은 API 호출의 HTTP 제한 시간을 더 높게 설정해야 합니다.
IN_INDEX_DOC IN_INDEX_DOC 전략은 색인에서 찾을 수 없는 URL의 실시간 문서 가져오기를 건너뜁니다. 지연 시간이 짧은 애플리케이션의 경우 IN_INDEX_DOC 전략을 사용하는 것이 좋습니다.

AMP URL

요청된 URL에 대한 AMP URL 응답입니다.

JSON 표현
{
  "originalUrl": string,
  "ampUrl": string,
  "cdnAmpUrl": string,
}
필드
originalUrl

string

AMP가 아닌 원래 URL.

ampUrl

string

게시자의 웹 서버를 가리키는 AMP URL입니다.

cdnAmpUrl

string

Google AMP Cache에서 캐시된 문서를 가리키는 AMP Cache URL입니다.

AMP URL 오류

요청된 URL의 AMP URL 리소스를 찾을 수 없습니다.

JSON 표현
{
  "errorCode": enum(ErrorCode),
  "errorMessage": string,
  "originalUrl": string,
}
필드
errorCode

enum(ErrorCode)

API 호출의 오류 코드입니다.

errorMessage

string

선택사항인 오류 메시지(선택사항)입니다.

originalUrl

string

AMP가 아닌 원래 URL.

ErrorCode

일괄 AMP URL 조회를 위한 오류 코드입니다.

열거형
ERROR_CODE_UNSPECIFIED 지정되지 않은 오류입니다.
INPUT_URL_NOT_FOUND 요청된 URL을 찾을 수 없음을 나타냅니다. URL을 찾을 수 없거나, Googlebot에서 액세스할 수 없거나, 기타 오류가 원인일 수 있습니다.
NO_AMP_URL 요청된 URL에 해당하는 AMP URL을 찾을 수 없음을 나타냅니다.
APPLICATION_ERROR 서버에서 발생한 애플리케이션 오류를 나타냅니다. 고객이 다시 시도하도록 안내했습니다.
URL_IS_VALID_AMP 지원 중단됨: 요청된 URL이 유효한 AMP URL임을 나타냅니다. 이는 오류가 아닌 상태이며 성공 또는 실패의 징후로 의존해서는 안 됩니다. 향후 API 버전에서 삭제될 예정입니다.
URL_IS_INVALID_AMP 요청 URL에 해당하는 AMP URL이 발견되었지만 유효한 AMP HTML이 아님을 나타냅니다.

사용해 보기