Edits

Google Play Developer Publishing API의 Edits 메서드를 사용하면 Google Play 앱의 여러 가지 변경사항을 준비한 다음 한 번에 배포할 수 있습니다. 이렇게 하려면 앱에 적용할 모든 변경사항이 포함된 edit을 만듭니다. Edit에는 다음과 같은 정보가 포함됩니다.

  • 앱과 연결된 APK 및 각 APK의 '트랙'

    각 APK는 '트랙'과 연결되어 있으며 트랙은 APK를 볼 수 있는 사용자를 결정합니다. 이렇게 하면 테스터에게 알파 및 베타 버전의 앱을 제공할 수 있습니다. 또한 앱의 한정 출시인 '단계적 출시' 버전을 제공할 수 있습니다. 이 앱은 개발자가 설정한 출시 비율에 따라 제한된 수의 앱 사용자에게 자동으로 제공되며, 이를 이용하여 점진적으로 앱의 새 프로덕션 버전을 배포할 수 있습니다.

  • 앱의 Google Play 스토어 등록정보 언어별 버전

    스토어 등록정보의 언어별 버전에는 스크린샷 및 기타 프로모션 그래픽, 현지화된 설명 등이 포함될 수 있습니다.

처음 edit을 만들면 생성된 edit은 앱의 현재 배포 상태의 사본입니다. 그다음, Edits 메서드를 호출하여 edit을 수정할 수 있습니다. edit이 준비되면 커밋하여 변경사항을 적용합니다. 언제든지 edit을 사용하지 않고 변경사항을 삭제하여 앱을 그대로 유지할 수도 있습니다.

이 API는 기존 앱(최소 하나의 APK가 업로드되어 있음)에 변경사항을 적용할 때만 사용할 수 있습니다. 따라서 이 API를 사용하려면 먼저 Play Console을 통해 하나 이상의 APK를 업로드해야 합니다. 또한 이 API를 사용하여 앱의 상태를 'published'에서 'unpublished'로 변경하거나 게시에 필요한 법적 동의를 작성하면 안 됩니다. 앱을 게시하려면 Play Console을 사용해야 합니다.

워크플로

이 섹션에서는 Google Play Developer Publishing API Edits 메서드를 사용하여 앱을 수정하는 일반적인 방법을 보여줍니다.

  1. Edits: Insert를 호출하여 새 edit을 만들고 수정할 앱을 지정합니다.

    그러면 지정된 앱의 새 edit이 생성됩니다. 앱의 모든 초기 설정(APK, 스토어 등록정보, 확장 파일 등)이 앱의 배포된 버전에서 복사됩니다.

  2. 원하는 대로 edit을 수정합니다.

    Google Play Console을 통해 할 수 있는 대부분의 변경 작업을 실행할 수 있습니다. Google Play Developer API에서 적절한 메서드를 호출하고 수정하려는 앱의 ID와 edit을 전달하면 됩니다. 다음은 구체적인 설명입니다.

    • Edits.apks: upload를 호출하여 새로운 APK를 업로드할 수 있습니다. 그러면 APK가 저장소 영역에 저장되므로 이 edit이나 후속 edit에서 트랙에 할당될 수 있습니다.
    • Edits.tracks: update를 호출하여 트랙에 APK를 할당할 수 있습니다. Edits.tracks: patch를 호출하여 기존 APK의 트랙 할당을 변경할 수도 있습니다.
    • Edits.listings: update를 호출하여 현지화된 스토어 등록정보를 새로 만들 수 있습니다. Edits.listings: patch를 호출하여 기존 스토어 등록정보를 수정할 수 있습니다.
    • Edits.expansionfiles resource 메서드를 호출하여 확장 파일을 추가하거나 수정할 수 있습니다.

    이러한 메서드는 진행 중인 edit에 변경사항을 적용하지만, 서비스 중인 버전의 앱은 수정하지 않습니다. 사용자 환경에 영향을 주지 않으면서 변경사항을 추가로 적용하거나 진행 중인 edit을 삭제할 수 있습니다.

  3. edit을 커밋합니다.

    Edits: commit을 호출할 때 유효성 검사 오류가 없으면 Edits 리소스에 지정된 모든 변경사항이 'live'로 전환되어 앱의 현재 상태가 교체됩니다. 이러한 변경사항은 Play Console을 통해 변경사항을 적용할 때와 같이 몇 시간이 걸릴 수 있습니다.