Products

このリソースのメソッドの一覧は、このページの最後に掲載されています。

リソース表記

プロダクトリソースは、企業の少なくとも一部のユーザーが利用できる Google Play ストアのアプリを表します。（一部のアプリは 1 つの企業に制限されており、その企業外ではそれらに関する情報は利用できません）。

各プロダクトについて提供される情報（ローカライズされた名前、アイコン、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)
        ]
      }
    ]
  }
}

プロパティ名	価値	説明
`appRestrictionsSchema`	`nested object`	アプリ制限スキーマ
`appRestrictionsSchema.kind`	`string`	非推奨。
`appRestrictionsSchema.restrictions[]`	`list`	このスキーマを構成する一連の制限。
`appRestrictionsSchema.restrictions[].defaultValue`	`nested object`	制限のデフォルト値。`bundle` と `bundleArray` の制限にデフォルト値はありません。
`appRestrictionsSchema.restrictions[].defaultValue.type`	`string`	指定された値の型。有効な値は次のとおりです。 "`bool`" "`bundle`" "`bundleArray`" "`choice`" "`hidden`" "`integer`" "`multiselect`" "`string`"
`appRestrictionsSchema.restrictions[].defaultValue.valueBool`	`boolean`	ブール値 - 型が bool の場合のみ存在します。
`appRestrictionsSchema.restrictions[].defaultValue.valueInteger`	`integer`	整数値 - タイプが整数の場合にのみ存在します。
`appRestrictionsSchema.restrictions[].defaultValue.valueMultiselect[]`	`list`	文字列値のリスト - タイプが複数選択の場合にのみ存在します。
`appRestrictionsSchema.restrictions[].defaultValue.valueString`	`string`	文字列値 - これは型が string、choice、非表示の場合に存在します。
`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` 制限は 2 レベル以下の深さになります。
`appRestrictionsSchema.restrictions[].restrictionType`	`string`	制限のタイプ。有効な値は次のとおりです。 "`bool`" "`bundle`" "`bundleArray`" "`choice`" "`hidden`" "`integer`" "`multiselect`" "`string`"
`appRestrictionsSchema.restrictions[].title`	`string`	制限の名前。
`appTracks[]`	`list`	企業に表示されるトラック。
`appTracks[].trackAlias`	`string`	トラックの変更可能な名前。これは Google Play Console に表示される名前です。
`appTracks[].trackId`	`string`	変更不可能な固有のトラック ID。この ID は、トラック情報を表示する Google Play Console ページの URL 内の releaseTrackId です。
`appVersion[]`	`list`	このプロダクトで現在利用可能なアプリのバージョン。
`appVersion[].isProduction`	`boolean`	このバージョンが製品版 APK の場合は true。
`appVersion[].targetSdkVersion`	`integer`	このアプリがターゲットとする SDK バージョン（APK のマニフェストで指定したもの）。詳しくは、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`	アプリのバージョンを表す、増加する一意の ID。
`appVersion[].versionString`	`string`	アプリデベロッパーがバージョンを識別するために Play ストアで使用する文字列。文字列が一意であったり、ローカライズされていたりするとは限りません（たとえば、「1.4」など）。
`authorName`	`string`	プロダクトの作成者の名前（アプリデベロッパーなど）。
`availableCountries[]`	`list`	このアプリを利用できる国。
`availableTracks[]`	`list`	非推奨。代わりに `appTracks` を使用してください。
`category`	`string`	アプリのカテゴリ（レーシング、ソーシャルなど）
`contentRating`	`string`	このアプリのコンテンツのレーティングです。指定できる値は次のとおりです。 "`all`" "`mature`" "`preTeen`" "`teen`"
`description`	`string`	ローカライズされたプロモーションの説明（利用可能な場合）。
`detailsUrl`	`string`	商品の（消費者）Google Play の詳細ページへのリンク。
`distributionChannel`	`string`	パッケージを提供する方法とユーザー。値 `publicGoogleHosted` は、パッケージが特定の企業に限定されず、Google Play ストアで購入できることを意味します。値 `privateGoogleHosted` は、パッケージが Google でホストされている限定公開アプリ（企業限定のアプリ）であることを意味します。値 `privateSelfHosted` は、パッケージが限定公開アプリ（企業限定のアプリ）であり、限定公開でホストされていることを意味します。指定できる値は次のとおりです。 "`privateGoogleHosted`" "`privateSelfHosted`" "`publicGoogleHosted`"
`features[]`	`list`	このプロダクトの注目すべき機能（ある場合）。
`fullDescription`	`string`	ローカライズされたアプリストアの詳しい説明（利用可能な場合）。
`iarcGenericRating`	`string`	このアプリのコンテンツのレーティングです。指定できる値は次のとおりです。 "`eighteenYears`" "`iarcGenericRatingUnspecified`" "`sevenYears`" "`sixteenYears`" "`threeYears`" "`twelveYears`"
`iconUrl`	`string`	商品のアイコンとして使用できる画像へのリンク。この画像は 512 x 512 ピクセル以下で使用するのに適しています。
`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 で URL セーフにエンコードされた証明書の SHA1 ハッシュ。（このフィールドのサポートは終了しており、SHA2-256 が採用されています。使用しないでください。また、いつでも削除される可能性があります）。
`signingCertificate.certificateHashSha256`	`string`	Base64 URL セーフでエンコードされた証明書の SHA2-256 ハッシュです。
`smallIconUrl`	`string`	商品のアイコンとして使用できる小さな画像へのリンク。この画像は最大 128 px x 128 ピクセルの使用に適しています。
`title`	`string`	商品名。
`workDetailsUrl`	`string`	プロダクトの managed Google Play 詳細ページへのリンク。企業の管理者が使用します。

メソッド

承認する

指定したサービスと関連するアプリの権限（存在する場合）を承認します。企業のお客様ごとに承認できるプロダクトの最大数は 1,000 です。

managed Google Play を使用して承認済みのアイテムをユーザーに表示するストアのレイアウトを設計、作成する方法については、ストアのレイアウトデザインをご覧ください。

generateApprovalUrl

サービスの権限（存在する場合）を表示するために iframe に表示できる URL を生成します。プロダクトを承認するには、企業の管理者が組織を代表してこれらの権限を確認し、承認する必要があります。

管理者は、EMM コンソールの個別の UI 要素を操作することで、表示された権限を承認する必要があります。これにより、プロダクトを承認するための Products.approve 呼び出しの approvalUrlInfo.approvalUrl プロパティとして、この URL の使用がトリガーされます。この URL は、最大 1 日の権限の表示にのみ使用できます。

get

企業の管理者に表示する商品の詳細を取得します。

getAppRestrictionsSchema

このプロダクトの構成可能なプロパティを定義するスキーマを取得します。すべての商品にはスキーマがありますが、管理対象の設定が定義されていない場合は、このスキーマを空にできます。このスキーマを使用すると、管理者がプロダクトを構成できる UI を作成できます。この API を使用して取得したスキーマに基づいて管理対象設定を適用するには、Play による管理対象設定をご覧ください。

getPermissions

このアプリに必要な Android アプリの権限を取得します。

list

クエリに一致する承認済みの商品を検索します。クエリがない場合は、承認済みのすべての商品を探します。

不承認

指定したサービス（および該当する場合は関連するアプリの権限）を不承認にします。