Google Play 開発者サービスの API を使用してアプリを開発するには、このページの手順に沿って、Google Maven リポジトリから入手できる関連 SDK を使用してプロジェクトをセットアップします。
Google Play 開発者サービスの使用時にアプリをテストするには、次のいずれかを使用する必要があります。
- Android 5.0（API レベル 21）以降を搭載し、Google Play ストア アプリがインストールされた互換性のある Android デバイス。
- Android 5.0（API レベル 21）以降をベースとする 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 開発者サービスの概要で説明したように、Google Play 開発者サービスは、Android 5.0（API レベル 21）以降が 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.5.0 |
スマートフォン、タブレット |
Android 広告 ID（AAID）com.google.android.gms:play-services-ads-identifier:18.0.1 |
スマートフォン、タブレット、Android TV、ChromeOS |
簡易版の Google モバイル広告com.google.android.gms:play-services-ads-lite:22.5.0 |
スマートフォン、タブレット |
検索向け AdSense（AFS）カスタム検索広告（CSA）com.google.android.gms:play-services-afs-native:19.0.3 |
スマートフォン、タブレット、ChromeOS |
Android 向け Google アナリティクス サービス SDKcom.google.android.gms:play-services-analytics:18.0.4 |
非推奨。代わりに Firebase 向け Google アナリティクスを使用してください。 |
アプリのインデックスcom.google.android.gms:play-services-appindex:16.1.0 |
スマートフォン、タブレット、Android TV |
Android アプリセット IDcom.google.android.gms:play-services-appset:16.0.2 |
スマートフォン、タブレット、Android TV、ChromeOS |
Android 向け Google ログインcom.google.android.gms:play-services-auth:20.7.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 Application Framework（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 コードスキャナcom.google.android.gms:play-services-code-scanner:16.1.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.1.0 |
スマートフォン、タブレット、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 Games サービス v2com.google.android.gms:play-services-games-v2:19.0.0 |
スマートフォン、タブレット、Android TV、Android Go、ChromeOS |
Android 用 Google Play Games サービス 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 Games サービス 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）以降を搭載しているデバイスでサポートされます。 |
Fused Location Provider for Android（操作の認識とジオフェンスを含む）com.google.android.gms:play-services-location:21.0.1
| スマートフォン、タブレット、Android TV、Auto、Android Go、ChromeOS、Wear OS |
Google Maps SDK for Androidcom.google.android.gms:play-services-maps:18.2.0 |
スマートフォン、タブレット、Android TV、Auto、Android Go、ChromeOS、Wear OS |
ML Kit のバーコード スキャンcom.google.android.gms:play-services-mlkit-barcode-scanning:18.3.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-beta5 |
スマートフォン、タブレット、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-subject-segmentation: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:19.0.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.4.0 |
スマートフォン、タブレット、Android Go、ChromeOS 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.4 |
スマートフォン、タブレット、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 |
Google Play 開発者サービス用の TensorFlow Lite GPU Delegate APIcom.google.android.gms:play-services-tflite-gpu:16.2.0 |
スマートフォン、タブレット、Android Go、ChromeOS |
Google Play 開発者サービス用の TensorFlow Lite Java APIcom.google.android.gms:play-services-tflite-java:16.1.0 |
スマートフォン、タブレット、Android Go、ChromeOS |
Google Play 開発者サービス用の TensorFlow Lite Support APIcom.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.1 |
スマートフォン、タブレット、Auto、Android Go、ChromeOS、Wear OS |
Wearable Data Layer APIcom.google.android.gms:play-services-wearable:18.1.0 |
スマートフォン、タブレット、Wear OS |
Gradle プラグイン
Google Play 開発者サービスには、次の表に示す複数の Gradle プラグインも含まれています。前の表の前に表示されているボタンを使用して、この表に表示される情報は変更されません。
| ユースケースと Gradle プラグイン名 | サポート対象デバイス |
|---|---|
オープンソース ライセンスを表示するcom.google.android.gms:oss-licenses-plugin:0.10.6 |
スマートフォン、タブレット、ChromeOS |
厳密なバージョン チェックcom.google.android.gms:strict-version-matcher-plugin:1.2.4 |
スマートフォン、タブレット、Android TV、Auto、Android Go、ChromeOS、Wear OS |