Skip to main content
계정은 익스피리언스를 몇 개 추가하든 앱을 한 번만 설치합니다. 따라서 설치에는 동기화 커서나 다른 시스템에서 연결된 계정의 ID처럼 하나의 익스피리언스가 아닌 계정에 속하는 상태가 저장됩니다. App Installations API를 사용하면 앱이 설치된 계정을 나열하고, 설치 하나를 조회하고, 앱이 설치에 보관하는 metadata와 external_id를 업데이트할 수 있습니다. 계정은 자신에게 설치된 앱을 나열할 수 있고, 개발자는 자신의 앱의 모든 설치를 나열할 수 있습니다. metadata와 external_id는 앱과 그 개발자만 볼 수 있으며, 앱만 변경할 수 있습니다.

엔드포인트

속성

string
필수
aag_ 접두사가 붙은 앱 설치 ID입니다.
object
필수
앱이 설치된 계정입니다.

속성

string
필수
biz_ 접두사가 붙은 계정 ID입니다.
string
필수
계정 표시 이름입니다.
object
필수
설치된 앱입니다.

속성

string
필수
app_ 접두사가 붙은 앱 ID입니다.
object
필수
앱을 개발하는 계정입니다.

속성

string
필수
biz_ 접두사가 붙은 계정 ID입니다.
string
필수
계정 표시 이름입니다.
object
필수
앱 아이콘입니다. 업로드된 아이콘이 없으면 기본 앱 아이콘이 사용됩니다.

속성

string
필수
아이콘 이미지 URL입니다. 항상 존재하며, 업로드된 아이콘이 없으면 기본 앱 아이콘입니다.
string
필수
앱 표시 이름입니다.
string
필수
앱이 계정에 처음 설치된 시각(ISO 8601 타임스탬프)입니다. 나중에 앱을 다시 설치해도 원래 시각이 유지됩니다.
string | null
필수
다른 시스템에서 연결된 계정의 ID처럼 앱이 이 설치에 부여한 자체 식별자이며, 설정되지 않은 경우 null입니다. 최대 255자이며 앱의 설치 전체에서 고유하므로 GET /app_installations?external_id=로 설치를 찾을 수 있습니다. 다른 설치에서 이미 사용 중인 값을 설정하면 409가 반환됩니다. 앱과 그 개발자만 볼 수 있으며, 앱이 설치된 계정에서는 항상 null입니다.
object | null
필수
동기화 커서나 다른 시스템에서 연결된 계정의 ID처럼 앱이 이 설치에 대해 저장하는 문자열 키와 값입니다. 앱이 키를 설정하기 전까지는 비어 있으며, 계정이 앱을 제거했다가 다시 설치해도 유지됩니다. 최대 50개의 키를 가질 수 있으며, 키는 최대 100자, 값은 최대 500자입니다. 앱만 변경할 수 있습니다. 앱과 그 개발자만 볼 수 있으며, 앱이 설치된 계정에서는 항상 null입니다.
boolean
필수
앱이 현재 계정이 아직 승인하지 않은 권한을 요청하는지 여부입니다.
string
필수
metadata 업데이트나 계정의 앱 권한 변경 등으로 설치가 마지막으로 변경된 시각(ISO 8601 타임스탬프)입니다.
AppInstallation