-
Notifications
You must be signed in to change notification settings - Fork 0
API 키 Google Books
Google Books 검색을 사용하려면 Google Cloud에서 API 키를 만들어야 합니다. 처음 보면 어렵게 느껴질 수 있지만, BookManager에서는 Google Books 검색용 키 하나만 만들면 됩니다.
이 문서는 Google Cloud를 처음 쓰는 사용자를 기준으로 설명합니다. Google Cloud 화면은 자주 바뀌므로 버튼 이름이 조금 다를 수 있습니다.
- Google 계정
- 웹 브라우저
- BookManager 앱
- Google Cloud Console에 접속합니다.
- 프로젝트를 만듭니다.
- Books API를 사용 설정합니다.
- API 키를 만듭니다.
- API 키 제한을 Books API로 설정합니다.
- BookManager에 붙여 넣습니다.
-
웹 브라우저를 엽니다.
-
아래 주소로 이동합니다.
-
Google 계정으로 로그인합니다.
-
처음 접속하면 국가, 약관 동의, 알림 설정 같은 화면이 나올 수 있습니다. 화면 안내에 따라 진행합니다.
Google Cloud에서는 API 키를 프로젝트 안에서 관리합니다.
-
화면 상단의 프로젝트 선택 영역을 누릅니다.
-
새 프로젝트를 선택합니다.
-
프로젝트 이름을 입력합니다.
BookManager
-
만들기 버튼을 누릅니다.
-
생성된 프로젝트가 선택되어 있는지 확인합니다.
이미 Google Cloud 프로젝트가 있다면 새로 만들지 않고 기존 프로젝트를 사용해도 됩니다.
- Google Cloud Console 상단 검색창에 Books API를 입력합니다.
- 검색 결과에서 Books API를 선택합니다.
- 사용 또는 Enable 버튼을 누릅니다.
사용 버튼이 보이지 않고 관리 버튼만 보이면 이미 사용 설정된 상태입니다.
- 왼쪽 메뉴에서 API 및 서비스로 이동합니다.
- 사용자 인증 정보 또는 Credentials 메뉴를 엽니다.
- 상단의 사용자 인증 정보 만들기를 누릅니다.
- API 키를 선택합니다.
- 새 API 키가 만들어지면 키 값을 복사합니다.
API 키는 길고 복잡한 문자열입니다. 일부만 복사하면 검색이 되지 않으므로 전체를 복사해야 합니다.
키를 만든 뒤에는 제한을 걸어 두는 것이 좋습니다. 제한을 걸면 키가 다른 Google API에 잘못 쓰이는 일을 줄일 수 있습니다.
- 방금 만든 API 키 이름을 클릭합니다.
- API 제한사항 또는 API restrictions 항목을 찾습니다.
- 키 제한을 선택합니다.
- API 목록에서 Books API를 선택합니다.
- 저장을 누릅니다.
애플리케이션 제한사항은 초보자라면 처음에는 없음으로 두는 편이 문제를 줄일 수 있습니다. BookManager는 데스크톱 앱이라 웹사이트 주소 제한을 걸면 검색이 막힐 수 있습니다.
키가 정상 동작하는 것을 확인한 뒤, Google Cloud 안내를 참고해 필요한 제한을 추가하면 됩니다.
- BookManager를 엽니다.
- 상단의 환경 설정 버튼을 누릅니다.
- API 및 검색 설정 영역을 찾습니다.
- Google Books API Key 입력칸에 복사한 키를 붙여 넣습니다.
- 저장을 누릅니다.
- 메타데이터 관리 탭에서 검색 API를 Google Books로 선택하고 검색해 봅니다.
Google Cloud는 계정 상태나 사용 설정에 따라 결제 정보 등록을 요구할 수 있습니다. BookManager는 Google Books 검색용 API 키만 사용하지만, Google Cloud의 정책은 Google 계정과 프로젝트 상태에 따라 달라질 수 있습니다.
결제 등록 화면이 나오면 내용을 충분히 확인한 뒤 진행하세요. 원하지 않으면 Google Books API 대신 리디북스, 알라딘, Amazon 등 다른 검색 소스를 사용할 수 있습니다.
- 현재 선택된 Google Cloud 프로젝트가 맞는지 확인합니다.
- Books API가 사용 설정되어 있는지 확인합니다.
- API 키 제한에서 Books API가 선택되어 있는지 확인합니다.
- 키 앞뒤에 빈칸이 들어가지 않았는지 확인합니다.
- BookManager 설정 저장 후 앱을 다시 실행해 봅니다.
- 키를 새로 만들었다면 몇 분 뒤 다시 검색해 봅니다.
- Google Books API 사용 안내: https://developers.google.com/books/docs/v1/using
- Google Cloud API 키 관리: https://cloud.google.com/docs/authentication/api-keys
- Google Cloud Console: https://console.cloud.google.com/