맥·모바일 개발Mac & mobile

app-store-connect-api-gotchas

App Store Connect 자동화에서 겪은 함정 모음입니다. 심사 제출 순서, 연령 등급의 광고 플래그, 스크린샷 추가 동작을 다룹니다.

어떤 문제를 푸나The problem

심사 제출 API의 정상 경로는 몇몇 지점에서 조용히 잘못된 일을 합니다. 새 버전에는 심사용 첨부가 따라오지 않고, 광고 앱은 광고 플래그를 켜지 않으면 사람이 보기 전에 자동으로 반려되며, 스크린샷 업로드는 덮어쓰지 않고 추가됩니다.

업데이트 제출 전 구간의 순서, 연령 등급 필드의 형식, 빌드된 아카이브에서 광고 ID를 확인하는 법, AdMob 연결 요령을 정리했습니다.

이런 분께 맞습니다Who it is for

App Store Connect API로 제출과 메타데이터를 자동화하는 인디 개발자.

무엇을 하나What it does

라이브 앱의 업데이트 제출을 순서대로 적고 조용히 새는 지점을 표시했습니다.
연령 등급: 필드마다 형이 다르고 409 응답이 짚어 주는 대로 맞추면 한 번에 수렴합니다.
스크린샷은 추가되므로 먼저 지워야 합니다.
광고 ID는 소스가 아니라 빌드된 아카이브에서 strings와 plutil로 확인합니다.

알아둘 한계Limits

지식 문서이지 클라이언트가 아닙니다. 제출은 fastlane이나 공식 API로 하십시오. 2026년 9월 관찰 기준이라 API는 바뀔 수 있습니다.
일부 내용은 문서화되지 않은 웹 엔드포인트와 로그인 세션 자동화를 다룹니다. 약관을 확인하고 세션 파일은 절대 공유하지 마십시오.

받아서 쓰기Get it

# 저장소를 받습니다
git clone https://github.com/Kein-chronicle/app-store-connect-api-gotchas.git

# Claude Code 스킬로 쓰려면 이 폴더 이름으로 받습니다
git clone https://github.com/Kein-chronicle/app-store-connect-api-gotchas.git ~/.claude/skills/asc-submission-gotchas

정보Info

분류Category: 맥·모바일 개발Mac & mobile
형태Type: 지식 문서Knowledge pack
라이선스License: MIT
필요한 것Requires: 없음 (SKILL.md를 읽기만 하면 됩니다)
저장소Repository: app-store-connect-api-gotchas
토픽Topics: app-store-connect ios app-store api automation admob release claude-skills

2026-10-18 기준: 저장소의 테스트를 로컬에서 실행해 통과했고, 예제 출력은 저장소의 examples 폴더를 실제로 실행한 결과입니다.