모든 가이드

저장 대상

Google Drive용 Google Cloud 프로젝트 만들기

Watermelon Backup에는 사용자가 만든 Google Cloud 프로젝트의 iOS OAuth 클라이언트 ID만 필요합니다. 서비스 계정, API 키, 클라이언트 보안 비밀, Drive 폴더를 직접 만들지 마세요.

업데이트 2026년 8월 16일

필요한 것

  • 백업을 저장할 Google 계정과 Google Cloud 프로젝트를 만들거나 선택할 권한.
  • iOS용 Watermelon Backup. Bundle ID는 정확히 com.zizicici.watermelon입니다.
  • 유료 Google Cloud 서비스, API 키, 서비스 계정, 클라이언트 보안 비밀, credentials.json, Firebase 프로젝트, 수동 Drive 폴더는 필요하지 않습니다.

프로젝트 만들기 및 Drive API 사용 설정

  • Google Cloud Console: New project를 열고 전용 프로젝트를 만들거나 선택합니다.
  • API Library의 Google Drive API를 열고 같은 프로젝트가 선택되었는지 확인한 뒤 사용 설정합니다.
  • 필요한 것은 Google Drive API뿐입니다. Drive Activity API, Google Picker API, API 키, 서비스 계정은 필요하지 않습니다.

Google Auth Platform 설정

  • Branding을 엽니다. 아직 설정되지 않았다면 Get started를 선택합니다.
  • 앱 이름은 Watermelon Backup처럼 알아보기 쉽게 쓰고 받을 수 있는 지원 이메일을 선택합니다.
  • Audience를 엽니다. Google Workspace 조직 내부에서만 사용할 때만 Internal, 그 외에는 External을 선택합니다.
  • External이 Testing인 동안 로그인할 Google 계정을 Test users에 추가합니다. 장기 백그라운드 백업에는 공개 HTTPS 홈페이지, 개인정보처리방침, 승인된 도메인 요구 사항을 완료한 뒤 Production으로 게시하거나 Internal을 사용하세요.

범위 추가

  • Data Access를 열고 Add or remove scopes를 선택합니다.
  • openid, https://www.googleapis.com/auth/userinfo.email, https://www.googleapis.com/auth/drive.file, https://www.googleapis.com/auth/drive.appdata를 추가합니다.
  • https://www.googleapis.com/auth/drive 또는 drive.readonly 같은 전체 Drive 범위는 추가하지 마세요.

iOS OAuth 클라이언트 만들기

  • Clients를 열고 Create client를 선택합니다.
  • Application type은 iOS, Bundle ID는 반드시 com.zizicici.watermelon으로 입력합니다.
  • Google이 명시적으로 요구하지 않는 한 App Store ID와 Team ID는 비워 둡니다.
  • 클라이언트를 만든 뒤 Firebase App Check가 표시되면 비활성 상태로 두고 강제 적용하지 마세요.
  • Client ID만 복사합니다. 반드시 .apps.googleusercontent.com으로 끝나야 합니다. 다른 기기, 재설치, 복원된 데이터베이스에서는 같은 Google Cloud 프로젝트, iOS Client ID, Google 계정을 사용하세요.

Watermelon Backup에서 사용

  • Google Drive를 추가하고 Client ID를 OAuth 클라이언트 ID에 붙여 넣습니다.
  • project ID, 숫자 프로젝트 번호, 클라이언트 보안 비밀, JSON 설정은 붙여 넣지 마세요.
  • 허용된 계정으로 Google에 로그인하고 모든 접근을 승인한 뒤 노드를 저장합니다.

Watermelon Backup 다운로드

App Store에서 Watermelon Backup을 설치한 뒤 이 가이드에 따라 iPhone에서 진행하세요.

무료로 받기