이 리소스에 대한 메소드 목록은 이 페이지의 하단에 나와 있습니다.
리소스 표현
제품 리소스는 기업 내 일부 사용자 이상이 사용할 수 있는 Google Play 스토어의 앱을 나타냅니다. (일부 앱은 단일 엔터프라이즈로 제한되며 해당 기업 외부에서는 앱에 대한 정보가 제공되지 않습니다.)
각 제품에 대해 제공된 정보 (현지화된 이름, 아이콘, 전체 Google Play 세부정보 페이지 링크)는 EMM 사용자 인터페이스 내에서 제품을 기본적으로 나타내기 위한 것입니다.
{ "kind": "androidenterprise#product", "productId": string, "title": string, "authorName": string, "iconUrl": string, "smallIconUrl": string, "detailsUrl": string, "workDetailsUrl": string, "requiresContainerApp": boolean, "appVersion": [ { "versionString": string, "versionCode": integer, "track": string, "targetSdkVersion": integer, "trackId": [ string ], "isProduction": boolean } ], "distributionChannel": string, "productPricing": string, "signingCertificate": { "certificateHashSha256": string, "certificateHashSha1": string }, "availableTracks": [ string ], "appTracks": [ { "trackId": string, "trackAlias": string } ], "description": string, "fullDescription": string, "screenshotUrls": [ string ], "category": string, "recentChanges": string, "minAndroidSdkVersion": integer, "contentRating": string, "lastUpdatedTimestampMillis": long, "permissions": [ { "permissionId": string, "state": string } ], "availableCountries": [ string ], "features": [ string ], "iarcGenericRating": string, "appRestrictionsSchema": { "kind": string, "restrictions": [ { "key": string, "title": string, "restrictionType": string, "description": string, "entry": [ string ], "entryValue": [ string ], "defaultValue": { "type": string, "valueBool": boolean, "valueString": string, "valueInteger": integer, "valueMultiselect": [ string ] }, "nestedRestriction": [ (AppRestrictionsSchemaRestriction) ] } ] } }
속성 이름 | 가치 | 설명 | Notes |
---|---|---|---|
appRestrictionsSchema |
nested object |
앱 제한 스키마 | |
appRestrictionsSchema.kind |
string |
지원 중단되었습니다. |
|
appRestrictionsSchema.restrictions[] |
list |
이 스키마를 구성하는 제한사항 집합입니다. | |
appRestrictionsSchema.restrictions[].defaultValue |
nested object |
제한의 기본값입니다. bundle 및 bundleArray 제한사항에는 기본값이 없습니다. |
|
appRestrictionsSchema.restrictions[].defaultValue.type |
string |
제공되는 값의 유형입니다.
사용 가능한 값은 다음과 같습니다.
|
|
appRestrictionsSchema.restrictions[].defaultValue.valueBool |
boolean |
부울 값 - 유형이 부울인 경우에만 존재합니다. | |
appRestrictionsSchema.restrictions[].defaultValue.valueInteger |
integer |
정수 값 - 유형이 정수인 경우에만 존재합니다. | |
appRestrictionsSchema.restrictions[].defaultValue.valueMultiselect[] |
list |
문자열 값 목록 - 유형이 다중 선택인 경우에만 표시됩니다. | |
appRestrictionsSchema.restrictions[].defaultValue.valueString |
string |
문자열 값 - 문자열, 선택 및 숨김 유형에 표시됩니다. | |
appRestrictionsSchema.restrictions[].description |
string |
제한사항에 대한 상세 설명(영향을 미치는 사항에 대한 세부정보 제공) | |
appRestrictionsSchema.restrictions[].entryValue[] |
list |
choice 또는 multiselect 제한의 경우 가능한 항목의 머신이 읽을 수 있는 값 목록입니다. 이러한 값은 구성에서 choice 제한의 단일 string 값 또는 multiselect 제한의 stringArray 로 사용되어야 합니다. |
|
appRestrictionsSchema.restrictions[].entry[] |
list |
choice 또는 multiselect 제한의 경우 가능한 항목의 사람이 읽을 수 있는 이름 목록입니다. |
|
appRestrictionsSchema.restrictions[].key |
string |
제품에서 제한사항을 식별하는 데 사용하는 고유 키입니다(예: 'com.google.android.gm.fieldname'). | |
appRestrictionsSchema.restrictions[].nestedRestriction[] |
list |
bundle 또는 bundleArray 제한의 경우 중첩된 제한 목록입니다. bundle 제한은 항상 bundleArray 제한 내에 중첩되며 bundleArray 제한은 최대 두 수준까지입니다. |
|
appRestrictionsSchema.restrictions[].restrictionType |
string |
제한사항의 유형입니다.
사용 가능한 값은 다음과 같습니다.
|
|
appRestrictionsSchema.restrictions[].title |
string |
제한사항의 이름입니다. | |
appTracks[] |
list |
기업에 표시되는 트랙 | |
appTracks[].trackAlias |
string |
트랙의 수정 가능한 이름입니다. Play Console에 표시되는 이름입니다. | |
appTracks[].trackId |
string |
수정할 수 없는 고유한 트랙 식별자입니다. 이 식별자는 트랙 정보를 표시하는 Play Developer Console 페이지의 URL에 있는 releaseTrackId입니다. | |
appVersion[] |
list |
현재 이 제품에서 사용할 수 있는 앱 버전입니다. | |
appVersion[].isProduction |
boolean |
이 버전이 프로덕션 APK인 경우 true입니다. | |
appVersion[].targetSdkVersion |
integer |
APK 매니페스트에 지정된 대로 이 앱이 타겟팅하는 SDK 버전입니다. 다음을 참조하세요. http://developer.android.com/guide/topics/manifest/uses-sdk-element.html | |
appVersion[].track |
string |
지원 중단되었으므로 대신 trackId 을 사용하세요.
사용 가능한 값은 다음과 같습니다.
|
|
appVersion[].trackId[] |
list |
앱 버전이 게시된 추적 ID입니다. track 필드 (지원 중단됨)를 대체하지만 프로덕션 트랙을 포함하지 않습니다 (대신 isProduction 참고). |
|
appVersion[].versionCode |
integer |
앱 버전의 고유하게 증가하는 식별자입니다. | |
appVersion[].versionString |
string |
앱 개발자가 Play 스토어에서 버전을 식별하는 데 사용하는 문자열입니다. 문자열이 고유하거나 현지화되지 않을 수도 있습니다 (예: 문자열은 '1.4'일 수 있음). | |
authorName |
string |
제품 작성자의 이름입니다 (예: 앱 개발자). | |
availableCountries[] |
list |
이 앱을 사용할 수 있는 국가입니다. | |
availableTracks[] |
list |
지원 중단되었으므로 대신 appTracks 을 사용하세요. |
|
category |
string |
앱 카테고리 (예: RACING, SOCIAL 등) | |
contentRating |
string |
이 앱의 콘텐츠 등급입니다.
허용되는 값은 다음과 같습니다.
|
|
description |
string |
현지화된 프로모션 설명입니다(해당하는 경우). | |
detailsUrl |
string |
제품에 대한 (소비자) Google Play 세부정보 페이지 링크 | |
distributionChannel |
string |
패키지를 제공하는 방법 및 제공 대상 publicGoogleHosted 값은 패키지가 Play 스토어를 통해 제공되며 특정 기업으로 제한되지 않음을 의미합니다. 값 privateGoogleHosted 은 패키지가 기업으로 제한된 비공개 앱이지만 Google에서 호스팅됨을 의미합니다. 값 privateSelfHosted 는 패키지가 기업으로 제한된 비공개 앱이며 비공개로 호스팅됨을 의미합니다.
사용 가능한 값은 다음과 같습니다.
|
|
features[] |
list |
이 제품의 주목할 만한 특징 (있는 경우)입니다. | |
fullDescription |
string |
현지화된 전체 앱 스토어 설명입니다(있는 경우). | |
iarcGenericRating |
string |
이 앱의 콘텐츠 등급입니다.
허용되는 값은 다음과 같습니다.
|
|
iconUrl |
string |
제품 아이콘으로 사용할 수 있는 이미지 링크입니다. 512x512픽셀까지 사용하기 적합한 이미지입니다. | |
kind |
string |
||
lastUpdatedTimestampMillis |
long |
앱이 마지막으로 게시된 대략적인 시간 (7일 이내)으로, 에포크 이후 밀리초 단위로 표시됩니다. | |
minAndroidSdkVersion |
integer |
앱을 실행하는 데 필요한 최소 Android SDK | |
permissions[] |
list |
앱에 필요한 권한 목록 | |
permissions[].permissionId |
string |
권한을 고유하게 식별하는 불투명 문자열입니다. | |
permissions[].state |
string |
권한 수락 여부입니다.
사용 가능한 값은 다음과 같습니다.
|
|
productId |
string |
app:<package name> 형식의 문자열입니다. 예를 들어 app:com.google.android.gm 은 Gmail 앱을 나타냅니다. |
|
productPricing |
string |
이 제품이 무료, 인앱 구매 시 무료 또는 유료인지 여부입니다. 가격을 알 수 없는 경우 제품을 소유한 사용자가 계속 구매할 수 있더라도 제품이 더 이상 정식 버전으로 제공되지 않는다는 의미입니다.
사용 가능한 값은 다음과 같습니다.
|
|
recentChanges |
string |
앱의 최근 변경사항에 대한 설명입니다. | |
requiresContainerApp |
boolean |
지원이 중단되었습니다. | |
screenshotUrls[] |
list |
앱을 나타내는 스크린샷 링크 목록입니다. | |
signingCertificate |
nested object |
이 제품에 서명하는 데 사용된 인증서입니다. | |
signingCertificate.certificateHashSha1 |
string |
인증서의 base64 urlsafe로 인코딩된 SHA1 해시입니다. (이 필드는 지원 중단되고 SHA2-256으로 대체되었습니다. 사용해서는 안 되며 언제든지 삭제할 수 있습니다.) |
|
signingCertificate.certificateHashSha256 |
string |
인증서의 base64 urlsafe로 인코딩된 SHA2-256 해시입니다. | |
smallIconUrl |
string |
제품 아이콘으로 사용할 수 있는 작은 이미지의 링크 128x128픽셀까지 사용하기 적합한 이미지입니다. | |
title |
string |
제품 이름입니다. | |
workDetailsUrl |
string |
기업 관리자가 사용할 수 있는 제품의 Managed Google Play 세부정보 페이지 링크입니다. |
방법
- 승인
지정된 제품 및 관련 앱 권한(있는 경우)을 승인합니다. 기업 고객당 승인할 수 있는 최대 제품 수는 1,000개입니다.
Managed Google Play를 사용하여 스토어 레이아웃을 디자인하고 만들어 승인된 제품을 사용자에게 표시하는 방법을 알아보려면 스토어 레이아웃 디자인을 참고하세요.
참고: 이 항목은 지원 중단되었습니다. 새 통합에서는 이 메서드를 사용할 수 없으며 새 권장사항을 참조할 수 있습니다.- generateApprovalUrl
- 제품의 권한 (있는 경우)을 표시하기 위해 iframe에서 렌더링할 수 있는 URL을 생성합니다. 기업 관리자가 해당 제품을 승인하려면 이러한 권한을 확인하고 조직을 대신하여 수락해야 합니다.
관리자는 EMM 콘솔에서 별도의 UI 요소와 상호작용하여 표시된 권한을 수락해야 합니다. 그러면Products.approve
호출에서 이 URL을approvalUrlInfo.approvalUrl
속성으로 사용하여 제품을 승인해야 합니다. 이 URL은 최대 1일간 권한을 표시하는 데만 사용할 수 있습니다. 참고: 이 항목은 지원 중단되었습니다. 새 통합에서는 이 메서드를 사용할 수 없으며 새 권장사항을 참조할 수 있습니다. - 받기
- 기업 관리자에게 표시할 제품 세부정보를 검색합니다.
- getAppRestrictionsSchema
- 이 제품의 구성 가능한 속성을 정의하는 스키마를 검색합니다. 모든 제품에는 스키마가 있지만 관리 구성이 정의되지 않은 경우에는 이 스키마가 비어 있을 수 있습니다. 이 스키마는 관리자가 제품을 구성할 수 있는 UI를 채우는 데 사용할 수 있습니다. 이 API를 사용하여 가져온 스키마를 기반으로 관리 구성을 적용하려면 Play를 통한 관리 구성을 참고하세요.
- getPermissions
- 이 앱에 필요한 Android 앱 권한을 검색합니다.
- list
- 쿼리와 일치하는 승인된 제품 또는 쿼리가 없는 경우 승인된 모든 제품을 찾습니다. 참고: 이 항목은 지원 중단되었습니다. 새 통합에서는 이 메서드를 사용할 수 없으며 새 권장사항을 참조할 수 있습니다.
- 승인 취소
- 지정된 제품 (있는 경우 관련 앱 권한)을 비승인합니다. 참고: 이 항목은 지원 중단되었습니다. 새 통합에서는 이 메서드를 사용할 수 없으며 새 권장사항을 참조할 수 있습니다.