Google Sheets 자주 발생하는 오류와 해결 방법

플렉스튜디오에서 구글 시트를 연동해 애플리케이션을 만들다 보면 처음에는 낯선 오류 메시지에 당황하실 수 있어요. 하지만 대부분은 설정이 올바르지 않아서 발생하는 경우가 많습니다. 이번 글에서는 디버거에서 자주 마주치는 오류를 소개하고 정확한 원인과 해결 방법을 알려드릴게요.

플렉스튜디오 유튜브에서 영상 강의 보러 가기 👇

1. 디버거 오류 : The incoming JSON object does not contain a client_email field

① 원인

• 디버깅할 때 지정한 사용자의 테넌트에 서비스 키 설정 문제가 있는 경우
• JSON 키 파일에 항목이 없거나, 올바르지 않은 키를 등록한 경우 발생

② 해결 방법

1. 현재 앱의 테넌트 정보 확인
   • 워크스페이스 좌측 상단의 ‘변경’ 버튼 클릭

• • 사용 중인 앱과 키가 등록된 테넌트가 일치하는지 확인

2. JSON 키 등록 여부 확인
   • 테넌트 설정(기본앱 기준) : 플렉스튜디오 워크스페이스 → 좌측 바에서 앱 선택 → DB/회원관리 → Data연결 → ‘바로가기’ 버튼 클릭
   • 초대앱의 테넌트 설정은 이 영상(링크 연결)을 참고해 주세요!
   • Service Account Key에 “등록된 JSON 파일이 있습니다” 문구 확인

• • 키가 깨졌거나 잘못된 파일일 수 있어요
  • JSON 키 파일 다운로드하는 방법 : Google Cloud 서비스 계정 → ‘키’ 탭 → 키 추가 → 새 키 만들기 → JSON선택

2. 디버거 오류 : The caller does not have permission

① 원인

• 구글 시트에서 서비스 계정에 편집 권한이 없을 때 발생

② 해결 방법

1. 구글 시트 상단의 ‘공유’ 버튼 클릭

2. 서비스 계정 이메일을 입력하고 권한을 '편집자'로 설정

3. 이미 등록되어 있다면 다시 한 번 메일 주소를 복사 후 재등록

3. 디버거 오류 : Requested entity was not found.

① 원인

• 잘못된 spreadsheet ID를 입력한 경우

② 해결 방법

1. 구글 시트 URL의 긴 문자열 복사

2. 서비스 정보의 spreadsheet 아이디 항목에 붙여넣기

4. 디버거 오류 : Unable to parse range:

① 원인

• 시나리오에서 지정한 Sheet 명이 구글 시트에 존재하지 않는 경우

② 해결 방법

1. 구글 시트 하단의 탭에서 정확한 Sheet 명 확인

2. 서비스 정보의 Sheet 명 항목에 붙여넣기

5. 디버거 오류 : Invalid PK Column

① 원인

• 플렉스튜디오 서비스 정보의 기준 컬럼명이 구글 시트에 잘못 작성된 경우

② 해결 방법

1. 구글 시트의 첫 번째 행을 확인해 기준 컬럼명이 포함되어 있는지 확인
   • 예시: 기준 컬럼명이 mail 이라면 첫 번째 행에 mail이 정확히 존재해야 함
2. 포함되어있지 않다면 컬럼명 추가 후 다시 실행

6. 함께 알아두면 좋은 정보 : 구글 시트에 데이터가 반영되지 않아요!

① 원인

• 오류 메시지는 아니지만, 컬럼명이 누락된 경우 구글 시트에 데이터가 반영되지 않음
• 플렉스튜디오 컬렉션 키와 구글 시트의 컬럼명이 일치해야 반영 가능

② 해결 방법

1. 시나리오에서 전송하는 섹터의 컬렉션 키 확인
2. 구글 시트 첫 번째 행에 해당 키와 동일한 컬럼명이 존재하는지 확인
3. 누락된 컬럼명이 있다면 추가 후 재실행

지금까지 시나리오에서 구글시트를 연동할 때 발생할 수 있는 오류와 해결 방법을 설명했는데요. 더 궁금한 점이 있다면 플렉스튜디오 가이드 문서를 참고하거나, 커뮤니티를 통해 질문을 남겨주세요!