엘가토 스트림덱 × 구글홈 2편
엘가토 스트림덱 구글홈 제어가 가끔 먹통이 된다면 원인은 하루 500회 공유 쿼터입니다. 2편에서는 무료 구글 클라우드 프로젝트를 만들고 Google Assistant API를 켠 뒤, 플러그인에 넣을 credentials.json 파일을 받는 과정을 단계별로 안내합니다.
엘가토 스트림덱 × 구글홈 시리즈
- 1편 · 준비물과 플러그인 설치
- 2편 · 구글 클라우드 프로젝트 만들기 (지금 보는 글)
- 3편 · 내 자격증명 연결과 작동 확인
왜 내 프로젝트가 필요한가
1편에서 만든 버튼, 어제까지 멀쩡하던 버튼이 오늘 갑자기 조용해졌습니다. 로그를 열어보니 쿼터 초과 오류가 찍혀 있었습니다. 플러그인은 기본적으로 개발자의 공유 프로젝트를 쓰는데, 모든 사용자가 하루 500회를 나눠 쓰는 구조라 누군가 먼저 다 쓰면 끝입니다.
내 프로젝트를 만들면 나만 쓰는 한도가 생깁니다. 공용 정수기 대신 내 물병을 챙기는 셈입니다.
준비물과 소요 시간
| 필요한 것 | 구글 계정 (구글홈에 쓰는 계정) |
|---|---|
| 소요 시간 | 약 10~15분 |
| 비용 | 0원 |
| 결과물 | credentials.json 파일 1개 |
프로젝트 만들고 API 켜기
1구글 클라우드 새 프로젝트 만들기에 접속해 구글 로그인합니다.
2프로젝트 이름에
streamdeck-assistant처럼 알아보기 쉬운 이름을 넣고 만들기를 누릅니다.3Google Assistant API 페이지로 이동합니다. 상단 프로젝트 이름이 방금 만든 것인지 확인하고 사용을 누릅니다.
버튼이 "사용"이 아니라 "관리"로 보이면 이미 켜진 상태입니다.
동의 화면 설정과 게시
1OAuth 동의 화면(Google 인증 플랫폼)으로 이동해 시작하기를 누릅니다.
2앱 이름(아무거나)과 사용자 지원 이메일(내 메일)을 넣습니다.
3대상은 외부를 고르고, 연락처 이메일을 넣은 뒤 정책에 동의하고 만들기를 누릅니다.
4왼쪽 메뉴 대상으로 가서 앱 게시를 눌러 프로덕션으로 바꿉니다.
"테스트" 상태로 두면 로그인이 7일마다 풀립니다. 꼭 앱 게시까지 하세요. 검증을 받으라는 안내가 떠도 개인용이라 무시해도 됩니다.
credentials.json 받기 (가장 중요)
1왼쪽 메뉴 클라이언트 → 클라이언트 만들기를 누릅니다. (사용자 인증 정보에서 OAuth 클라이언트 ID를 만들어도 같습니다)
2애플리케이션 유형은 반드시 데스크톱 앱을 고르고 만들기를 누릅니다.
3생성 완료 창에서 JSON 다운로드를 누르고, 파일 이름을
credentials.json으로 바꿔 보관합니다.창을 닫기 전에 꼭 다운로드하세요. 2025년 6월부터 구글이 클라이언트 보안 비밀을 마스킹하기 시작해서, 생성 창을 닫으면 다시 볼 수 없습니다.
받은 파일을 메모장으로 열었을 때 {"installed":로 시작하고, client_id 앞 숫자가 내 프로젝트 번호면 정상입니다.
자주 묻는 질문
Q. JSON을 못 받고 창을 닫았어요.
클라이언트를 하나 새로 만들고 이번에는 바로 다운로드하면 됩니다.
Q. 이 파일을 다른 사람에게 줘도 되나요?안 됩니다. 비밀번호 같은 정보가 들어 있으니 블로그·카톡·메일에 올리지 마세요.
Q. "확인되지 않은 앱" 경고가 떠요.내가 만든 앱이라 뜨는 정상 경고입니다. 3편에서 넘기는 방법을 안내합니다.
총평
메뉴 이름이 낯설어서 그렇지, 버튼 몇 개 누르면 끝나는 작업입니다. 핵심은 딱 두 가지, 앱 게시와 JSON 즉시 다운로드입니다. 파일이 준비됐다면 3편에서 플러그인에 연결합니다.
스트림덱이 아직 없다면 엘가토 스트림덱 최저가 보기
제가 한번 써봤습니다.