이 페이지는 Cloud Translation API를 통해 번역되었습니다.

Dynamic Links

Google 도서 동적 링크 기능을 사용하면 사이트에서 Google 도서로 더 맞춤설정할 수 있고 안정적인 링크를 만들 수 있습니다. 예를 들어 이 도구를 사용하면 Google 색인에 도서가 있을 때만 표시되는 '스마트' 링크를 생성하거나 사용자에게 Google 도서에서 책을 미리 볼 수 있는지 알려주는 링크를 표시할 수 있습니다. 동적 링크 기능을 사용하면 Google 도서로 연결되는 링크에 썸네일 이미지를 포함할 수도 있습니다. 이 문서를 통해 사이트에 이 기능을 신속하게 추가할 수 있습니다.

참고: 이 기능은 이전에 도서 조회가능성 API로 알려졌습니다.

미리보기 마법사는 동적 링크 위에 구축된 도구로, 코드 몇 줄만 복사해도 사이트의 미리보기를 더욱 쉽게 연결할 수 있습니다. 이 문서는 도서검색 링크 방식을 맞춤설정하려는 고급 개발자를 대상으로 합니다.

시청자층

동적 링크 문서는 Google 도서 내 도서로 연결되는 웹 애플리케이션을 개발하려는 프로그래머를 위해 개발되었습니다. 이 문서에서는 사용자가 HTTP 프로토콜 및 기본 자바스크립트에 익숙하다고 가정합니다.

도서 검색 용어

Google 도서는 사용자의 현지 저작권 제한을 준수하므로 일부 지역에서 일부 도서의 미리보기 또는 전체보기 기능이 제공되지 않습니다. 조회가능성은 다음 클래스로 클러스터링됩니다.

전체 화면: 책 전체를 볼 수 있습니다. 이러한 도서는 공개 도메인에 속할 수 있습니다.
일부 미리보기: 도서의 일부를 볼 수 있습니다. 이 도서는 저작권 보호를 받으며 Google 도서에 이러한 페이지에 대한 액세스 권한을 부여했습니다. 이러한 도서는 사용자가 전체 페이지를 볼 수 있다는 점에서 발췌문 보기와 다릅니다.
스니펫 보기 및 미리보기 없음: 사용자에게는 '도서 정보' 페이지만 표시됩니다. 도서의 짧은 발췌문만 사용할 수 있습니다. 도서가 스캔되지 않았거나 저작권 보호를 받고 있으며 Google 도서에서 사용자의 검색어와 관련된 몇 개 이상의 발췌문을 노출할 수 있는 권한을 받지 못했습니다.

소개

정적 링크 문서에서는 Google 도서에서 특정 도서의 페이지로 연결되는 URL을 생성하는 매우 간단한 방법을 설명합니다. 안타깝게도 Google 도서 색인에 특정 도서가 없거나 특정 지역에 거주하는 사용자가 미리보기를 사용할 수 없는 경우도 있습니다. 정적 링크는 '블라인드'이므로 의도된 효과를 내지 못하는 경우가 있습니다.

동적 링크는 자바스크립트를 사용하여 도서의 조회가능성을 쿼리하는 또 다른 프로그래매틱 클라이언트 측 방법을 제공합니다. 이렇게 하면 도서검색에 더 안정적이고 예측 가능한 링크를 추가하여 사용자에게 더 일관된 경험을 제공할 수 있습니다. 조회가능성은 최종 사용자의 위치에 따라 다르므로 동적 링크 인터페이스는 서버 측 또는 오프라인 쿼리용으로 설계되지 않았습니다.

동적 링크의 기능에 대해 알아보려면 이 문서 끝에 있는 코드 샘플을 참조하세요.

브랜드 가이드라인

동적 링크를 렌더링할 때는 Google Books API 제품군에 적용되는 브랜드 가이드라인을 준수해야 합니다. 특히

저작자 표시 및 Google 도서 링크를 유지해야 합니다.
Google 도서의 미리보기에 연결할 때는 승인된 Google 미리보기 버튼만 사용해야 합니다.
텍스트 링크, 버튼, 문서 또는 설명 텍스트는 승인된 이름 지정 규칙을 준수해야 합니다. 예를 들어 Google 도서 미리보기에 연결할 때는 동사 '다운로드'를 사용해서는 안 됩니다. 공개 도메인 저작물만 다운로드할 수 있기 때문입니다.

브랜드 예시

Freakonomics: 악의적인 경제학자가 모든 것의 숨겨진 측면을 탐색함

스티븐 레빗, 스티븐 더브너 저

이 문서 끝에 있는 샘플 섹션에서는 현재 브랜드 가이드라인을 준수하는 추가 예를 확인할 수 있습니다.

클라이언트 측 API

클라이언트 측 동적 링크의 핵심은 개발자가 하나 이상의 책에 관한 정보를 요청하는 URL을 구성하고 <script> 태그를 사용하여 Google 도서에 요청을 보낼 수 있게 해주는 URL 형식입니다.

구문 예:: <script src="https://books.google.com/books?bibkeys=ISBN:0451526538&jscmd=viewapi&callback=mycallback"></script>

요청 형식

URL의 형식은 책에 연결하는 데 사용되는 URL 구문과 유사하지만 책 ID 필드에 쉼표로 구분된 책 ID가 여러 개 포함될 수 있으며 추가 ''jscmd'' 및 '콜백' 매개변수가 있습니다. 원하는 경우 추가 인수가 있어 조회가능성 필터를 제어할 수 있습니다.

동적 링크는 ISBN, OCLC 번호, LCCN 키 등 책을 식별하는 다양한 방법을 지원합니다. 이 API는 GET 요청의 최대 크기까지 일괄 쿼리를 허용합니다.

ISBN: &bibkeys=ISBN:0451526538(API는 ISBN 10과 13을 모두 지원합니다.)
OCLC: &bibkeys=OCLC:36792831
LLC: &bibkeys=LCCN:96072233

JSON 결과 형식

이 호출로 응답하면 요청된 도서에 대한 정보가 하나 이상의 JSON 객체로 반환됩니다. JSON 객체는 다음 구조를 사용합니다.

JsonSearchResult {
    string bib_key;
    string info_url;
    string preview_url;
    string thumbnail_url;
    string preview;
};

이 필드는 다음 정보를 제공합니다.

bi_key: 책을 쿼리하는 데 사용되는 식별자입니다.
정보_URL: 도서에 관한 정보가 포함된 페이지 (도서 정보 페이지)의 URL입니다.
미리보기 URL: 책 미리보기의 URL로, 사용자를 책 표지로 바로 이동시킵니다. 요청에 발췌문 보기 또는 미리보기 책만 사용할 수 있는 경우 미리보기 URL이 반환되지 않습니다.
썸네일 이미지 URL: 책 표지 썸네일의 URL입니다.
미리보기: 책의 조회가능성 상태를 나타내는 값: full (전체보기 도서), partial (일부 미리보기만 해당) 또는 noview (발췌문 또는 미리보기 없음 도서)
삽입 가능: 도서 검색 삽입된 뷰어를 사용하여 도서를 제3자 페이지에 삽입할 수 있는 경우 이 불리언은 true입니다.

Dynamic Links

콘텐츠

시청자층

도서 검색 용어

소개

브랜드 가이드라인

브랜드 예시

클라이언트 측 API

요청 형식

JSON 결과 형식

매개변수 및 추가 필드

동기 모드와 비동기 모드 비교

비동기 모드

동기 모드

자주 묻는 질문(FAQ)

코드 샘플