가입 및 API 키

Google Awareness API를 사용하려면 앱에 Google API 키를 추가해야 합니다. 필요한 API 키 유형은 Android API 키입니다.

모든 Android 앱은 비공개 키를 보유한 디지털 인증서로 서명됩니다. 디지털 인증서에 대한 자세한 내용은 앱 서명 방법에 관한 Android 가이드를 참고하세요.

Android API 키는 특정 인증서-패키지 쌍에 연결됩니다. 앱의 사용자 수와 관계없이 인증서당 하나의 키만 있으면 됩니다.

앱의 키를 얻으려면 여러 단계를 거쳐야 합니다. 이 가이드에 자세히 설명되어 있으며 다음과 같이 요약됩니다.

  1. 앱의 인증서에 관한 정보를 가져옵니다.
  2. Google Developers Console에 프로젝트를 등록하고 사용자 컨텍스트 API를 프로젝트의 서비스로 추가합니다.
  3. 키를 요청합니다.
  4. 앱에 키를 추가합니다. 이렇게 하려면 앱 매니페스트에 요소를 추가합니다.

앱의 인증서 정보 찾기

API 키는 SHA-1 디지털 지문이라고 하는 간단한 형식의 앱 디지털 인증서를 기반으로 합니다. 인증서의 SHA-1 디지털 지문을 표시하려면 먼저 올바른 인증서를 사용해야 합니다. 다음 두 가지 인증서 중에서 선택할 수 있습니다.

  • 디버그 인증서: 디버그 빌드를 실행할 때 Android SDK 도구에서 자동으로 생성하는 인증서입니다. 이 인증서는 테스트 중인 앱에만 사용하세요. 디버그 인증서로 서명된 앱은 게시하지 마세요. 디버그 인증서는 Android 개발자 문서의 디버그 빌드 서명 섹션에 자세히 설명되어 있습니다.
  • 출시 인증서: 출시 빌드를 실행할 때 Android SDK 도구에서 이 인증서를 생성합니다. keytool 프로그램을 사용하여 이 인증서를 생성할 수도 있습니다. 앱을 출시할 준비가 되면 이 인증서를 사용하세요.

keytool에 대한 자세한 내용은 Oracle 문서를 참고하세요.

디버그 인증서

디버그 인증서 디지털 지문 표시

keytool 프로그램을 -v 매개변수와 함께 사용하여 인증서의 SHA-1 디지털 지문을 표시합니다. 그러려면 다음 단계를 완료하세요.

  1. 디버그 키스토어 파일을 찾습니다. 파일 이름은 debug.keystore이며 프로젝트를 처음 빌드할 때 생성됩니다. 기본적으로 파일은 Android Virtual Device (AVD) 파일과 동일한 디렉터리에 저장됩니다.

    • OS X 및 Linux: ~/.android/
    • Windows Vista 및 Windows 7: C:\Users\your_user_name\.android\

  2. SHA-1 지문 표시:

    • Linux 또는 OS X의 경우 터미널 창을 열고 다음을 입력합니다.

      keytool -list -v -keystore ~/.android/debug.keystore -alias androiddebugkey -storepass android -keypass android

    • Windows Vista 및 Windows 7의 경우 다음을 실행합니다.

      keytool -list -v -keystore "%USERPROFILE%\.android\debug.keystore" -alias androiddebugkey -storepass android -keypass android

다음과 비슷한 출력이 표시됩니다.

Alias name: androiddebugkey
Creation date: Jan 01, 2013
Entry type: PrivateKeyEntry
Certificate chain length: 1
Certificate[1]:
Owner: CN=Android Debug, O=Android, C=US
Issuer: CN=Android Debug, O=Android, C=US
Serial number: 4aa9b300
Valid from: Mon Jan 01 08:04:04 UTC 2013 until: Mon Jan 01 18:04:04 PST 2033
Certificate fingerprints:
     MD5:  AE:9F:95:D0:A6:86:89:BC:A8:70:BA:34:FF:6A:AC:F9
     SHA1: BB:0D:AC:74:D3:21:E1:43:07:71:9B:62:90:AF:A1:66:6E:44:5D:75
     Signature algorithm name: SHA1withRSA
     Version: 3
출시 인증서

출시 인증서 디지털 지문 표시

keytool 프로그램을 -v 매개변수와 함께 사용하여 인증서의 SHA-1 디지털 지문을 표시합니다. 그러려면 다음 단계를 완료하세요.

  1. 릴리스 인증서 키스토어 파일을 찾습니다. 출시 키 저장소에는 기본 위치 또는 이름이 없습니다. 출시용 앱을 빌드할 때 이를 지정하지 않으면 빌드에서 .apk를 서명되지 않은 상태로 두며 여기에 먼저 서명해야 게시할 수 있습니다. 출시 인증서의 경우 인증서의 별칭, 키 저장소의 비밀번호, 인증서도 필요합니다.

  2. 다음을 입력하여 키 저장소에 있는 모든 키의 별칭을 나열합니다.

    keytool -list -keystore your_keystore_name
  3. your_keystore_name을 키 저장소의 정규화된 경로와 이름으로 바꿉니다. .keystore 확장 프로그램을 포함합니다. 메시지가 표시되면 키 저장소의 비밀번호를 입력합니다. 그런 다음 keytool에 키 저장소에 있는 모든 별칭이 표시됩니다.

  4. 터미널이나 명령 프롬프트에서 다음을 입력합니다.

          keytool -list -v -keystore your_keystore_name -alias your_alias_name
  5. your_keystore_name을 키 저장소의 정규화된 경로와 이름으로 바꿉니다. .keystore 확장 프로그램을 포함합니다.
  6. your_alias_name을 인증서를 만들 때 인증서에 할당한 별칭으로 대체합니다.

다음과 비슷한 출력이 표시됩니다.

Alias name: <alias_name>
Creation date: Feb 02, 2013
Entry type: PrivateKeyEntry
Certificate chain length: 1
Certificate[1]:
Owner: CN=Android Debug, O=Android, C=US
Issuer: CN=Android Debug, O=Android, C=US
Serial number: 4cc9b300
Valid from: Mon Feb 02 08:01:04 UTC 2013 until: Mon Feb 02 18:05:04 PST 2033
Certificate fingerprints:
    MD5:  AE:9F:95:D0:A6:86:89:BC:A8:70:BA:34:FF:6B:AC:F9
    SHA1: BB:0D:AC:74:D3:21:E1:43:67:71:9B:62:90:AF:A1:66:6E:44:5D:75
    Signature algorithm name: SHA1withRSA
    Version: 3

SHA1으로 시작하는 행에 인증서의 SHA-1 디지털 지문이 포함됩니다. 디지털 지문은 콜론으로 구분된 20개의 두 자리 16진수 시퀀스입니다.

Google Developers Console에서 API 키 가져오기

Google Awareness API를 시작하려면 키 가져오기 버튼을 클릭하세요. 이 도구는 Google Developers Console로 연결되어 절차를 안내하고 Awareness API를 자동으로 활성화합니다.

키 가져오기

또는 다음 단계에 따라 API 키를 가져옵니다.

  1. Google Developers Console로 이동합니다.
  2. 프로젝트를 선택하거나 새 프로젝트를 만듭니다.
  3. 계속을 클릭하여 Awareness API를 사용 설정합니다.

  4. '사용자 인증 정보' 페이지에서 Android 키를 만들고 API 사용자 인증 정보를 설정합니다.

  5. '키 만들기' 대화상자에서 사용량을 Android 앱으로 제한해야 합니다. 이렇게 하려면 다음 예와 같이 앱의 SHA-1 디지털 지문과 패키지 이름을 입력합니다.

    BB:0D:AC:74:D3:21:E1:43:67:71:9B:62:91:AF:A1:66:6E:44:5D:75

com.example.android.awareness-example

  6. 만들기를 클릭합니다. 새 Android API 키가 프로젝트의 API 키 목록에 표시됩니다. API 키는 다음과 같은 문자열입니다.

    AIzaSyBdVl-cTICSwYKrZ95LoVuw7dbMuDt1KG0

이제 API 키가 있으므로 시작하기 가이드에 설명된 대로 앱의 매니페스트에 추가할 수 있습니다.

추가 API 활성화

Awareness API를 사용하면 비콘과 같은 여러 유형의 컨텍스트 데이터에 액세스할 수 있습니다. 이러한 유형을 사용하려면 Google Developers Console에서 해당 API를 사용 설정해야 합니다.

서비스 Awareness API 메서드 사용 설정할 API
비콘 SnapshotApi.getBeaconState(), FenceApi.BeaconFence Nearby Messages API