Products

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

リソース表記

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	ブール値 - 型がブール値の場合にのみ存在します。
appRestrictionsSchema.restrictions[].defaultValue.valueInteger	integer	整数値 - タイプが整数の場合にのみ存在します。
appRestrictionsSchema.restrictions[].defaultValue.valueMultiselect[]	list	文字列値のリスト - タイプが複数選択の場合にのみ存在します。
appRestrictionsSchema.restrictions[].defaultValue.valueString	string	文字列値 - string、choice、hidden タイプの場合に存在します。
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 です。この識別子は、トラック情報を表示する 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	増加するアプリ バージョンの一意の識別子。
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 は、パッケージが特定の企業に制限されず、Play ストアで入手可能であることを意味します。値 privateGoogleHosted は、パッケージが限定公開アプリ（企業限定）だが、Google によってホストされていることを意味します。値 privateSelfHosted は、パッケージが限定公開アプリ（企業に制限）であり、非公開でホストされていることを意味します。 有効な値は次のとおりです。 "privateGoogleHosted" "privateSelfHosted" "publicGoogleHosted"
features[]	list	このプロダクトの注目すべき機能（ある場合）。
fullDescription	string	ローカライズされたアプリストアの完全な説明（利用可能な場合）。
iarcGenericRating	string	このアプリのコンテンツのレーティング。 有効な値は次のとおりです。 "eighteenYears" "iarcGenericRatingUnspecified" "sevenYears" "sixteenYears" "threeYears" "twelveYears"
iconUrl	string	商品のアイコンとして使用できる画像へのリンク。この画像は、512px x 512px まででの使用に適しています。
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	商品のアイコンとして使用できる小さい画像へのリンク。この画像は 128px x 128px 以下での使用に適しています。
title	string	商品名。
workDetailsUrl	string	企業の管理者が使用する、プロダクトの managed Google Play の詳細ページへのリンク。

Methods

承認する

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

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

注: このアイテムのサポートは終了しました。新しい統合ではこのメソッドは使用できません。 新しい推奨事項をご覧ください。

generateApprovalUrl

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

管理者は、EMM コンソールの別の UI 要素を操作して、表示された権限を承認する必要があります。これにより、サービスを承認するための Products.approve 呼び出しで、この URL が approvalUrlInfo.approvalUrl プロパティとして使用されるようになります。この URL は、権限の表示に最長 1 日間のみ使用できます。 注: このアイテムのサポートは終了しました。新しい統合ではこのメソッドは使用できません。 新しい推奨事項をご覧ください。

get

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

getAppRestrictionsSchema

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

getPermissions

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

list

クエリと一致する承認済み商品を検索します。クエリがない場合は、承認済みのすべての商品を検索します。 注: このアイテムのサポートは終了しました。新しい統合ではこのメソッドは使用できません。 新しい推奨事項をご覧ください。

不承認

指定した商品（および関連するアプリの権限がある場合はその権限）を承認解除します。 注: このアイテムのサポートは終了しました。新しい統合ではこのメソッドは使用できません。 新しい推奨事項をご覧ください。