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

Dynamic Links

Google 도서 동적 링크 기능을 사용하면 내 사이트에서 더욱 맞춤설정 가능하고 신뢰할 수 있는 Google 도서 링크를 만들 수 있습니다. 예를 들어 도서가 Google 색인에 포함되어 있을 때만 표시되는 '스마트' 링크를 생성할 수도 있고, Google 도서에서 책을 미리보기할 수 있는지 여부를 사용자에게 알려주는 링크를 표시할 수도 있습니다. 동적 링크 기능을 사용하면 Google 도서 링크에 썸네일 이미지를 포함할 수도 있습니다. 이 문서에서는 이 기능을 사이트에 빠르게 추가할 수 있습니다.

참고: 이 기능은 이전에는 Book Visibility API라고 했습니다.

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

시청자층

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

도서 검색 용어

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

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

소개

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

동적 링크는 JavaScript를 사용하여 책의 조회가능성을 쿼리하기 위한 프로그래매틱 방식의 클라이언트 측 대체 메서드를 제공합니다. 이를 통해 도서 검색에 보다 안정적이고 예측 가능한 링크를 포함하여 사용자에게 보다 일관된 환경을 제공할 수 있습니다. 조회가능성은 최종 사용자의 위치에 따라 달라지므로 동적 링크 인터페이스는 서버 측 또는 오프라인 쿼리에 맞게 설계되지 않았습니다.

동적 링크의 기능을 알아보려면 이 문서 마지막에 나오는 코드 샘플로 건너뛰세요.

브랜드 가이드라인

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

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

브랜딩 예

프리코노믹스: 불량 경제학자, 모든 것의 숨겨진 면을 탐구하다

작성자: Steven Levitt 및 Stephen Dubner

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

클라이언트 측 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' 및 'callback' 매개변수가 있습니다. 원하는 경우 조회가능성 필터를 제어하기 위한 추가 인수가 있을 수 있습니다.

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

ISBN: &bibkeys=ISBN:0451526538 (API는 ISBN 10 및 13을 모두 지원합니다.)
OCLC: &bibkeys=OCLC:36792831
미국 국회도서관 제어번호(LCCN): &bibkeys=LCCN:96072233

JSON 결과 형식

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

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

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

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

Dynamic Links

목차

시청자층

도서 검색 용어

소개

브랜드 가이드라인

브랜딩 예

클라이언트 측 API

요청 형식

JSON 결과 형식

매개변수 및 추가 필드

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

비동기 모드

동기 모드

자주 묻는 질문(FAQ)

코드 샘플