特定のデバイスでの分析や不正行為防止などのユースケースでは、組織が所有する一連のアプリの使用状況やアクションを関連付ける必要がある場合があります。Google Play 開発者サービスには、アプリセット ID というプライバシーに配慮したオプションが用意されています。
アプリセット ID のスコープ
アプリセット ID には、次のいずれかの定義済みスコープを設定できます。特定の ID が関連付けられているスコープを確認するには、getScope() を呼び出します。
Google Play デベロッパー スコープ
Google Play ストアによってインストールされたアプリの場合、App Set ID API は、同じ Google Play デベロッパー アカウントで公開されたアプリセットにスコープされた ID を返します。
たとえば、Google Play デベロッパー アカウントで 2 つのアプリを公開し、両方のアプリが Google Play ストアから同じデバイスにインストールされているとします。アプリは、そのデバイスで同じアプリセット ID を共有します。アプリが異なる鍵で署名されている場合でも、ID は同じです。
アプリのスコープ
アプリセット ID SDK は、次のいずれかの条件下で、特定のデバイス上の呼び出し元のアプリ自体に固有の ID を返します。
アプリは Google Play ストア以外のインストーラによってインストールされている。
Google Play 開発者サービスがアプリの Google Play デベロッパー アカウントを特定できません。
アプリが Google Play 開発者サービスのないデバイスにインストールされている。
アプリセット ID のキャッシュに保存された値に依存しない
デバイスに Google Play ストアからインストールされた特定のアプリセットのアプリセット ID は、次のいずれかの条件でリセットできます。
同じ ID 値を共有するアプリのグループが、アプリセット ID API に 13 か月以上アクセスしていない。
特定のアプリセットの最後のアプリがデバイスからアンインストールされた。
お客様がデバイスを出荷時の設定にリセットします。
アプリは、必要に応じて SDK を使用して ID 値を取得する必要があります。
アプリセット ID SDK をアプリに追加する
次のスニペットは、アプリセット ID ライブラリを使用する build.gradle ファイルの例を示しています。
次のサンプル スニペットは、Google Play 開発者サービスの Tasks API を使用してアプリセット ID を非同期で取得する方法を示しています。
Kotlin
valclient=AppSet.getClient(applicationContext)asAppSetIdClientvaltask:Task<AppSetIdInfo>=client.appSetIdInfoasTask<AppSetIdInfo>task.addOnSuccessListener({// Determine current scope of app set ID.valscope:Int=it.scope// Read app set ID value, which uses version 4 of the// universally unique identifier (UUID) format.valid:String=it.id})
Java
Contextcontext=getApplicationContext();AppSetIdClientclient=AppSet.getClient(context);Task<AppSetIdInfo>task=client.getAppSetIdInfo();task.addOnSuccessListener(newOnSuccessListener<AppSetIdInfo>(){@OverridepublicvoidonSuccess(AppSetIdInfoinfo){// Determine current scope of app set ID.intscope=info.getScope();// Read app set ID value, which uses version 4 of the// universally unique identifier (UUID) format.Stringid=info.getId();}});
[null,null,["最終更新日 2025-08-17 UTC。"],[],[],null,["# Identify developer-owned apps\n\nFor use cases such as analytics or fraud prevention on a given device, you may\nneed to correlate usage or actions across a set of apps owned by your\norganization. [Google Play services](https://developers.google.com/android)\noffers a privacy-friendly option called [*app set ID*](https://developers.google.com/android/reference/com/google/android/gms/appset/AppSetIdInfo).\n\nApp set ID scope\n----------------\n\nThe app set ID can have one of the following defined scopes. To determine which\nscope a particular ID is associated with, call\n[`getScope()`](https://developers.google.com/android/reference/com/google/android/gms/appset/AppSetIdInfo#getScope()).\n| **Caution:** When Google Play services updates from a version that only supports app scope to a version that supports developer scope, the app set ID's value is reset automatically, without any developer action. See [other reasons developers\n| shouldn't rely on a cached value of the app set ID](#dont-rely-on-cached-value).\n\n### Google Play developer scope\n\n| **Note:** The app set SDK attempts to return app set IDs that have the developer scope without any additional developer action, unless the app satisfies the conditions for app scope, described below.\n\nFor apps that are installed by the Google Play store, the app set ID API returns\nan ID scoped to the set of apps published under the same Google Play developer\naccount.\n\nFor example, suppose you publish two apps under your Google Play developer\naccount and both apps are installed on the same device through the Google Play\nstore. The apps share the same app set ID on that device. The ID is the same\neven if the apps are signed by different keys.\n\n### App scope\n\nUnder any of the following conditions, the app set ID SDK returns an ID unique\nto the calling app itself on a given device:\n\n- The app is installed by an installer other than the Google Play store.\n- Google Play services is unable to determine an app's Google Play developer account.\n- The app is installed on a device without Google Play services.\n\nDon't rely on a cached value of app set ID\n------------------------------------------\n\nUnder any of the following conditions, the app set ID for a given set of Google\nPlay store-installed apps on a device can be reset:\n\n- The app set ID API hasn't been accessed by the groups of apps that share the same ID value for over 13 months.\n- The last app from a given set of apps is uninstalled from the device.\n- The user performs a factory reset of the device.\n\nYour app should use the SDK to retrieve the ID value every time it's needed.\n\nAdd the app set ID SDK to your app\n----------------------------------\n\nThe following snippet shows an example `build.gradle` file that uses the app set\nID library: \n\n dependencies {\n implementation 'com.google.android.gms:play-services-appset:16.1.0'\n }\n\nThe following sample snippet demonstrates how you can retrieve the app set ID\nasynchronously using the [Tasks\nAPI](https://developers.google.com/android/guides/tasks) in Google Play\nservices: \n\n### Kotlin\n\n```kotlin\nval client = AppSet.getClient(applicationContext) as AppSetIdClient\nval task: Task\u003cAppSetIdInfo\u003e = client.appSetIdInfo as Task\u003cAppSetIdInfo\u003e\n\ntask.addOnSuccessListener({\n // Determine current scope of app set ID.\n val scope: Int = it.scope\n\n // Read app set ID value, which uses version 4 of the\n // https://en.wikipedia.org/wiki/Universally_unique_identifier.\n val id: String = it.id\n})\n```\n\n### Java\n\n```java\nContext context = getApplicationContext();\nAppSetIdClient client = AppSet.getClient(context);\nTask\u003cAppSetIdInfo\u003e task = client.getAppSetIdInfo();\n\ntask.addOnSuccessListener(new OnSuccessListener\u003cAppSetIdInfo\u003e() {\n @Override\n public void onSuccess(AppSetIdInfo info) {\n // Determine current scope of app set ID.\n int scope = info.getScope();\n\n // Read app set ID value, which uses version 4 of the\n // https://en.wikipedia.org/wiki/Universally_unique_identifier.\n String id = info.getId();\n }\n});\n```"]]