이 오류 메시지는 Google Sheets API를 사용하려고 했지만 해당 프로젝트(956087464383)에서 아직 API가 활성화되지 않았거나 사용된 적이 없어서 발생한 문제입니다. 아래 내용을 참고해서 원인을 이해하고 해결할 수 있습니다.
🔍 오류 메시지 해석
Google Sheets API has not been used in project 956087464383 before or it is disabled. Enable it by visiting https://console.developers.google.com/apis/api/sheets.googleapis.com/overview?project=956087464383 then retry. If you enabled this API recently, wait a few minutes for the action to propagate to our systems and retry
이 메시지는 다음과 같은 의미입니다:
- Google Sheets API를 현재 프로젝트에서 사용한 적이 없음
- 또는 API가 비활성화되어 있음
- 방금 API를 활성화한 경우라면, 시스템에 적용되는 데 몇 분이 걸릴 수 있음
✅ 해결 방법 (단계별 설명)
1. Google Cloud Console 접속
- 위 링크를 클릭하면 Google Sheets API 개요 페이지로 이동합니다.
- 이동한 프로젝트가 정확히 956087464383 인지 확인하세요.
- 만약 본인의 프로젝트가 아니라면, 좌측 상단의 드롭다운 메뉴에서 본인의 프로젝트를 선택해야 합니다.
2. Google Sheets API 활성화하기
- “Enable” 또는 “활성화” 버튼이 보인다면 클릭하세요.
- 이미 활성화된 경우에는 버튼이 비활성화돼 있고, “API enabled” 같은 문구가 보입니다.
3. OAuth 권한 및 인증 정보 확인
Sheets API를 사용할 때는 보통 OAuth 2.0 인증이 필요합니다. 아래와 같이 인증을 준비하세요:
- Google Cloud Console의 API 및 서비스 > 사용자 인증 정보 페이지로 이동
- OAuth 클라이언트 ID 또는 서비스 계정 키를 생성합니다.
- API 호출 시 이 인증 정보를 사용해야 합니다.
4. 적용 지연 시간 고려하기
- API를 방금 활성화한 경우, 시스템 전파까지 몇 분이 걸릴 수 있습니다.
- 5~10분 정도 기다린 후 다시 시도해보세요.
5. 프로젝트 ID가 정확한지 확인
해당 오류가 본인의 프로젝트가 아닌, 다른 사람의 프로젝트 ID를 잘못 사용한 경우일 수도 있습니다. 예를 들어:
- project=956087464383 이 본인의 프로젝트가 아니라면, 제대로 권한이 없는 상태일 수 있음.
- 본인의 프로젝트 ID를 명확히 알고 있는지 확인하고, 해당 프로젝트에서 API를 활성화하세요.
🧪 추가 팁
- Google Sheets API 사용 예제를 실행 중이라면, 코드 내에서 project_id나 credentials.json 경로가 정확한지 다시 점검하세요.
- 특히 Python이나 Node.js에서 Google API 클라이언트를 사용하는 경우, 다음 설정이 중요합니다:
from googleapiclient.discovery import build
from google.oauth2.service_account import Credentials
SCOPES = ['https://www.googleapis.com/auth/spreadsheets']
SERVICE_ACCOUNT_FILE = 'credentials.json'
credentials = Credentials.from_service_account_file(
SERVICE_ACCOUNT_FILE, scopes=SCOPES)
service = build('sheets', 'v4', credentials=credentials)
- 인증 파일이 정확하고, 해당 서비스 계정이 스프레드시트에 접근 권한을 가지고 있는지도 확인하세요.
🔗 참고 링크
- Google Sheets API 개요 페이지
- API 및 서비스 대시보드
- OAuth 인증 정보 생성하기 가이드
- 공식 문서 - Google Sheets API Python Quickstart
필요하다면 사용 중인 코드나 어떤 방식으로 Google Sheets API를 호출하고 있는지 알려줘. 더 정확하게 디버깅 도와줄 수 있어!
