Products

이 리소스에 대한 메소드 목록은 이 페이지의 하단에 나와 있습니다.

리소스 표현

제품 리소스는 기업 내 일부 사용자 이상이 사용할 수 있는 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 제한의 기본값입니다. bundlebundleArray 제한사항에는 기본값이 없습니다.
appRestrictionsSchema.restrictions[].defaultValue.type string 제공되는 값의 유형입니다.

사용 가능한 값은 다음과 같습니다.
  • "bool"
  • "bundle"
  • "bundleArray"
  • "choice"
  • "hidden"
  • "integer"
  • "multiselect"
  • "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 제한사항의 유형입니다.

사용 가능한 값은 다음과 같습니다.
  • "bool"
  • "bundle"
  • "bundleArray"
  • "choice"
  • "hidden"
  • "integer"
  • "multiselect"
  • "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을 사용하세요.

사용 가능한 값은 다음과 같습니다.
  • "alpha"
  • "beta"
  • "production"
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 이 앱의 콘텐츠 등급입니다.

허용되는 값은 다음과 같습니다.
  • "all"
  • "mature"
  • "preTeen"
  • "teen"
description string 현지화된 프로모션 설명입니다(해당하는 경우).
detailsUrl string 제품에 대한 (소비자) Google Play 세부정보 페이지 링크
distributionChannel string 패키지를 제공하는 방법 및 제공 대상 publicGoogleHosted 값은 패키지가 Play 스토어를 통해 제공되며 특정 기업으로 제한되지 않음을 의미합니다. 값 privateGoogleHosted은 패키지가 기업으로 제한된 비공개 앱이지만 Google에서 호스팅됨을 의미합니다. 값 privateSelfHosted는 패키지가 기업으로 제한된 비공개 앱이며 비공개로 호스팅됨을 의미합니다.

사용 가능한 값은 다음과 같습니다.
  • "privateGoogleHosted"
  • "privateSelfHosted"
  • "publicGoogleHosted"
features[] list 이 제품의 주목할 만한 특징 (있는 경우)입니다.
fullDescription string 현지화된 전체 앱 스토어 설명입니다(있는 경우).
iarcGenericRating string 이 앱의 콘텐츠 등급입니다.

허용되는 값은 다음과 같습니다.
  • "eighteenYears"
  • "iarcGenericRatingUnspecified"
  • "sevenYears"
  • "sixteenYears"
  • "threeYears"
  • "twelveYears"
iconUrl string 제품 아이콘으로 사용할 수 있는 이미지 링크입니다. 512x512픽셀까지 사용하기 적합한 이미지입니다.
kind string
lastUpdatedTimestampMillis long 앱이 마지막으로 게시된 대략적인 시간 (7일 이내)으로, 에포크 이후 밀리초 단위로 표시됩니다.
minAndroidSdkVersion integer 앱을 실행하는 데 필요한 최소 Android SDK
permissions[] list 앱에 필요한 권한 목록
permissions[].permissionId string 권한을 고유하게 식별하는 불투명 문자열입니다.
permissions[].state string 권한 수락 여부입니다.

사용 가능한 값은 다음과 같습니다.
  • "accepted"
  • "required"
productId string app:<package name> 형식의 문자열입니다. 예를 들어 app:com.google.android.gm은 Gmail 앱을 나타냅니다.
productPricing string 이 제품이 무료, 인앱 구매 시 무료 또는 유료인지 여부입니다. 가격을 알 수 없는 경우 제품을 소유한 사용자가 계속 구매할 수 있더라도 제품이 더 이상 정식 버전으로 제공되지 않는다는 의미입니다.

사용 가능한 값은 다음과 같습니다.
  • "free"
  • "freeWithInAppPurchase"
  • "paid"
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
쿼리와 일치하는 승인된 제품 또는 쿼리가 없는 경우 승인된 모든 제품을 찾습니다. 참고: 이 항목은 지원 중단되었습니다. 새 통합에서는 이 메서드를 사용할 수 없으며 새 권장사항을 참조할 수 있습니다.
승인 취소
지정된 제품 (있는 경우 관련 앱 권한)을 비승인합니다. 참고: 이 항목은 지원 중단되었습니다. 새 통합에서는 이 메서드를 사용할 수 없으며 새 권장사항을 참조할 수 있습니다.