Google Play 開発者サービス API を使用してアプリを開発するには、Google Maven リポジトリから入手可能な、関連する SDK を使用してプロジェクトを設定する手順を実施します。
Google Play 開発者サービスを使用するときにアプリをテストするには、次のいずれかを使用する必要があります。
- Android 4.4（API レベル 19）以降を搭載し、Google Play ストア アプリがインストールされている、互換性のある Android デバイス。
- Android 4.4（API レベル 19）以降をベースにした Google API プラットフォームを実行する AVD を備えた Android Emulator。
Google Play 開発者サービスの依存関係を宣言する
アプリで Google Play 開発者サービス API に依存する機能を開発するには、次の手順を行います。
アプリのモジュール ディレクトリ内にある
build.gradleファイルを開きます。アプリに必要な SDK ごとに、その SDK の依存関係を含めます。 このページでは、Android アプリの一般的な Google Play 開発者サービスの依存関係の一覧を示します。Firebase の依存関係をプロジェクトに追加することもできます。
変更を保存して、プロジェクトを同期します。
次のスニペットは、位置情報ライブラリを使用する build.gradle ファイルの例を示しています。
apply plugin: 'com.android.application'
...
dependencies {
implementation 'com.google.android.gms:play-services-location:21.0.1'
}
バグ修正と新機能を含む Google Play 開発者サービス SDK の新しいバージョンが定期的にリリースされます。これらの更新はリリースノートで発表されます。更新された依存関係をアプリが使用している場合、これらの修正を利用するには、アプリの依存関係を最新バージョンに変更してください。
Google Play 開発者サービスがインストールされているかどうかを確認する
Google Play 開発者サービスの概要で説明したように、Android 4.4（API レベル 19）以降では、Google Play 開発者サービスは Google Play ストア アプリを通じて自動更新されます。ただし、Google Play ストアがインストールされていない Android デバイスには Google Play 開発者サービスはインストールされていません。Google Play 開発者サービスを含まないデバイスでアプリを実行する場合、Google API を使用する前に、Google Play 開発者サービスがデバイスにインストールされているかどうかを確認するか、Google Play 開発者サービスが機能する必要があるアプリの機能を有効にすることをおすすめします。
デバイスに Google Play 開発者サービスが存在するかどうかを確認するには、isGooglePlayServicesAvailable() メソッドを使用します。
その後、Google Play 開発者サービスへの接続を開始するか、インストールされている Google Play 開発者サービスのバージョンが特定の API をサポートしているかどうかを確認するには、Google API へのアクセスのガイドをご覧ください。
Google Play 開発者サービスの依存関係
次の表に、Android アプリに含めることができる Google Play 開発者サービスの依存関係を示します。いずれかのボタンを選択して、デバイスタイプ別にリストをフィルタできます。また、ボタンの後に表示されるボックスに、特定のユースケースまたは依存関係名を入力して検索することもできます。
| ユースケースと依存関係の名前 | サポートされているデバイス |
|---|---|
Google モバイル広告com.google.android.gms:play-services-ads:22.1.0 |
スマートフォン、タブレット |
Android 広告 ID（AAID）com.google.android.gms:play-services-ads-identifier:18.0.1 |
スマートフォン、タブレット、Android TV、Chrome OS |
軽量版の Google モバイル広告com.google.android.gms:play-services-ads-lite:22.1.0 |
スマートフォン、タブレット |
検索向け AdSense（AFS）のカスタム検索広告（CSA）com.google.android.gms:play-services-afs-native:19.0.3 |
スマートフォン、タブレット、Chrome OS |
Android 向け Google アナリティクス サービス SDKcom.google.android.gms:play-services-analytics:18.0.2 |
非推奨。代わりに、Firebase 向け Google アナリティクスを使用してください。 |
App Indexcom.google.android.gms:play-services-appindex:16.1.0 |
スマートフォン、タブレット、Android TV |
Android アプリセット IDcom.google.android.gms:play-services-appset:16.0.2 |
スマートフォン、タブレット、Android TV、Chrome OS |
Android 向け Google ログインcom.google.android.gms:play-services-auth:20.5.0 |
スマートフォン、タブレット、Android TV、Auto、Android Go、ChromeOS |
SMS Retriever APIcom.google.android.gms:play-services-auth-api-phone:18.0.1 |
スマートフォン、タブレット、Android Go |
Block Store API（ユーザー認証情報ストレージを含む）com.google.android.gms:play-services-auth-blockstore:16.2.0 |
スマートフォン、タブレット、Android Go、ChromeOS |
Google Awareness APIcom.google.android.gms:play-services-awareness:19.0.1 |
スマートフォン、タブレット、Auto、Android Go、ChromeOS |
ユーティリティ クラスcom.google.android.gms:play-services-base:18.2.0 |
スマートフォン、タブレット、Android TV、Auto、Android Go、ChromeOS、Wear OS |
ユーティリティ クラスの偽物をテストするcom.google.android.gms:play-services-base-testing:16.0.0 |
スマートフォン、タブレット、Android TV、Auto、Android Go、ChromeOS、Wear OS |
その他のユーティリティ クラスcom.google.android.gms:play-services-basement:18.2.0 |
スマートフォン、タブレット、Android TV、Auto、Android Go、ChromeOS、Wear OS |
Google Castcom.google.android.gms:play-services-cast:21.3.0 |
スマートフォン、タブレット、Android Go、ChromeOS |
Google Cast アプリケーション フレームワーク（CAF）com.google.android.gms:play-services-cast-framework:21.3.0 |
スマートフォン、タブレット、Android Go、ChromeOS |
Android TV レシーバーcom.google.android.gms:play-services-cast-tv:21.0.0 |
Android TV |
Google Code Scannercom.google.android.gms:play-services-code-scanner:16.0.0 |
スマートフォン、タブレット、Android Go、ChromeOS |
Chromium ネットワーク スタック（Cronet）com.google.android.gms:play-services-cronet:18.0.1 |
スマートフォン、タブレット、Android TV、Auto、Android Go、ChromeOS、Wear OS |
デバイス間のインタラクション（DTDI）com.google.android.gms:play-services-dtdi:16.0.0-beta01 |
スマートフォン、タブレット、Android Go |
Fast IDentity Online（FIDO）認証com.google.android.gms:play-services-fido:20.0.1 |
スマートフォン、タブレット、Android TV、Auto、Android Go、ChromeOS、Wear OS Android 7.0（API レベル 24）以降を搭載しているデバイスでサポートされます。 |
Android 向け Google Fit APIcom.google.android.gms:play-services-fitness:21.1.0 |
スマートフォン、タブレット、Android Go、ChromeOS、Wear OS |
Android 向け Google Play ゲームサービス v2com.google.android.gms:play-services-games-v2:17.0.0 |
スマートフォン、タブレット、Android TV、Android Go、ChromeOS |
Android 向け Google Play ゲームサービス v2 Native C SDKcom.google.android.gms:play-services-games-v2-native-c:17.0.0-beta1 |
スマートフォン、タブレット、Android TV、Android Go、ChromeOS |
Android 向け Google Play ゲームサービス v1com.google.android.gms:play-services-games:23.1.0 |
スマートフォン、タブレット、Android TV、Android Go、ChromeOS |
Matter APIcom.google.android.gms:play-services-home:16.0.0 |
スマートフォン、タブレット |
Google Play Instantcom.google.android.gms:play-services-instantapps:18.0.1 |
スマートフォン、タブレット、Android TV、Android Go、ChromeOS Android 5.0（API レベル 21）以降を搭載しているデバイスでサポートされています。 |
Android 用 Fused Location Provider（アクティビティ認識とジオフェンスを含む）com.google.android.gms:play-services-location:21.0.1
| スマートフォン、タブレット、Android TV、Auto、Android Go、ChromeOS、Wear OS |
Android 向け Google Maps SDKcom.google.android.gms:play-services-maps:18.1.0 |
スマートフォン、タブレット、Android TV、Auto、Android Go、ChromeOS、Wear OS |
ML Kit のバーコード スキャンcom.google.android.gms:play-services-mlkit-barcode-scanning:18.2.0 |
スマートフォン、タブレット、Android Go、ChromeOS |
ML Kit の顔検出com.google.android.gms:play-services-mlkit-face-detection:17.1.0 |
スマートフォン、タブレット、Android Go、ChromeOS |
ML Kit の画像ラベル付けcom.google.android.gms:play-services-mlkit-image-labeling:16.0.8 |
スマートフォン、タブレット、Android Go、ChromeOS |
ML Kit 画像のラベル付けのカスタムcom.google.android.gms:play-services-mlkit-image-labeling-custom:16.0.0-beta4 |
スマートフォン、タブレット、Android Go、ChromeOS |
ML Kit 言語識別com.google.android.gms:play-services-mlkit-language-id:17.0.0 |
スマートフォン、タブレット、Android Go、ChromeOS |
ML Kit スマート リプライcom.google.android.gms:play-services-mlkit-smart-reply:16.0.0-beta1 |
スマートフォン、タブレット、Android Go、ChromeOS |
ML Kit のテキスト認識com.google.android.gms:play-services-mlkit-text-recognition:19.0.0 |
スマートフォン、タブレット、Android Go、ChromeOS |
中国語の ML Kit テキスト認識com.google.android.gms:play-services-mlkit-text-recognition-chinese:16.0.0 |
スマートフォン、タブレット、Android Go、ChromeOS |
Devanagari の ML Kit テキスト認識com.google.android.gms:play-services-mlkit-text-recognition-devanagari:16.0.0 |
スマートフォン、タブレット、Android Go、ChromeOS |
ML Kit テキスト認識（日本語）com.google.android.gms:play-services-mlkit-text-recognition-japanese:16.0.0 |
スマートフォン、タブレット、Android Go、ChromeOS |
韓国語による ML Kit のテキスト認識com.google.android.gms:play-services-mlkit-text-recognition-korean:16.0.0 |
スマートフォン、タブレット、Android Go、ChromeOS |
付近のデバイスの検出と接続com.google.android.gms:play-services-nearby:18.5.0 |
スマートフォン、タブレット、Android TV、Auto、Android Go |
オープンソース ライセンスを表示com.google.android.gms:play-services-oss-licenses:17.0.1 |
スマートフォン、タブレット、Android TV、Auto、Android Go、ChromeOS Android 5.0（API レベル 21）以降を搭載しているデバイスでサポートされています。 |
画面ロックの品質チェック com.google.android.gms:play-services-password-complexity:18.0.1 |
スマートフォン、タブレット、Android Go、ChromeOS、Wear OS Android 4.4（API レベル 19）から Android 9（API レベル 28）を搭載したデバイスでサポートされています。 |
Google Pay for Passescom.google.android.gms:play-services-pay:16.1.0 |
スマートフォン、タブレット、Android Go、Chrome OS Android 5.0（API レベル 20）以降を搭載しているデバイスでサポートされています。 |
アプリ インストルメンテーション用の reCAPTCHA Enterprisecom.google.android.gms:play-services-recaptcha:17.0.1 |
スマートフォン、タブレット、Android TV、Android Go、ChromeOS |
SafetyNet API（デバイスの証明書、セーフ ブラウジング、reCAPTCHA、アプリの確認を含む）com.google.android.gms:play-services-safetynet:18.0.1 |
スマートフォン、タブレット、Android TV、Auto、Android Go、ChromeOS |
Google タグ マネージャーcom.google.android.gms:play-services-tagmanager:18.0.2 |
スマートフォン、タブレット、Android TV、Android Go、ChromeOS |
Android の Tasks APIcom.google.android.gms:play-services-tasks:18.0.2 |
スマートフォン、タブレット、Android TV、Auto、Android Go、ChromeOS、Wear OS |
Android 向けアクセラレーション サービスcom.google.android.gms:play-services-tflite-acceleration-service:16.0.0-beta01 |
スマートフォン、タブレット、Android Go、ChromeOS |
TensorFlow Lite GPU Delegate API for Google Play 開発者サービスcom.google.android.gms:play-services-tflite-gpu:16.2.0 |
スマートフォン、タブレット、Android Go、ChromeOS |
TensorFlow Lite Java API for Google Play 開発者サービスcom.google.android.gms:play-services-tflite-java:16.1.0 |
スマートフォン、タブレット、Android Go、ChromeOS |
TensorFlow Lite Support API for Google Play 開発者サービスcom.google.android.gms:play-services-tflite-support:16.1.0 |
スマートフォン、タブレット、Android Go、ChromeOS |
Thread Network APIcom.google.android.gms:play-services-threadnetwork:16.0.0 |
スマートフォン、タブレット |
モバイル ビジョンcom.google.android.gms:play-services-vision:20.1.3 |
スマートフォン、タブレット、Android Go、ChromeOS |
Android での Google Pay によるお支払いcom.google.android.gms:play-services-wallet:19.2.0-beta01 |
スマートフォン、タブレット、Auto、Android Go、ChromeOS、Wear OS |
Wearable Data Layer APIcom.google.android.gms:play-services-wearable:18.0.0 |
スマートフォン、タブレット、Wear OS |
Gradle プラグイン
以下の表に示すように、Google Play 開発者サービスには複数の Gradle プラグインも含まれています。なお、前の表より前に表示されるボタンでは、この表に表示される情報は変更されません。
| ユースケースと Gradle プラグイン名 | サポートされているデバイス |
|---|---|
オープンソース ライセンスを表示com.google.android.gms:oss-licenses-plugin:0.10.6 |
スマートフォン、タブレット、Chrome OS |
厳密なバージョン チェックcom.google.android.gms:strict-version-matcher-plugin:1.2.4 |
スマートフォン、タブレット、Android TV、Auto、Android Go、ChromeOS、Wear OS |