Google Play 開発者サービス API を使用してアプリを開発するには、このページの手順に沿って、Google maven リポジトリから入手できる関連する SDK を使ってプロジェクトをセットアップします。
Google Play 開発者サービスを使用するアプリをテストするには、次のいずれかを使用する必要があります。
- Android 6.0（API レベル 23）以上を搭載し、Google Play ストア アプリがインストールされている、互換性のある Android デバイス。
- Android 6.0（API レベル 23）以降ベースの 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.3.0'
}
バグの修正と新機能を含む Google Play 開発者サービス SDK の新しいバージョンが定期的にリリースされます。これらの更新は、リリースノートで発表されます。アプリで更新された依存関係を使用している場合は、アプリの依存関係を最新バージョンに変更して、これらの修正を活用してください。
Google Play 開発者サービスがインストールされているかどうかを確認する
Google Play 開発者サービスの概要で説明したように、Android 6.0（API レベル 23）以降では、Google Play ストア アプリを通じて Google Play 開発者サービスが自動的に更新されます。ただし、Google Play ストアが搭載されていないデバイスには、Google Play 開発者サービスはインストールされません。Google Play 開発者サービスのないデバイスでアプリが動作する場合は、Google API を使用しようとする前や、Google API を必要とする機能を有効にする前に、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:24.7.0 |
スマートフォン、タブレット |
Android 広告 ID（AAID）com.google.android.gms:play-services-ads-identifier:18.2.0 |
スマートフォン、タブレット、Android TV、ChromeOS |
Google モバイル広告の軽量版com.google.android.gms:play-services-ads-lite:24.6.0 |
スマートフォン、タブレット |
検索向け AdSense（AFS）カスタム検索広告（CSA）com.google.android.gms:play-services-afs-native:19.1.0 |
スマートフォン、タブレット、ChromeOS |
Android 向け Google アナリティクス サービス SDKcom.google.android.gms:play-services-analytics:18.1.1 |
非推奨。代わりに Firebase 向け Google アナリティクスを使用してください。 |
App Indexcom.google.android.gms:play-services-appindex:16.2.0 |
スマートフォン、タブレット、Android TV |
AppSearchcom.google.android.gms:play-services-appsearch:16.0.1 |
スマートフォン、タブレット、Android TV |
Android アプリセット IDcom.google.android.gms:play-services-appset:16.1.0 |
スマートフォン、タブレット、Android TV、ChromeOS |
Android 向け Google ログインcom.google.android.gms:play-services-auth:21.4.0 |
スマートフォン、タブレット、Android TV、Auto、Android Go、ChromeOS |
SMS Retriever APIcom.google.android.gms:play-services-auth-api-phone:18.3.0 |
スマートフォン、タブレット、Android Go |
Block Store API（ユーザー認証情報の保存を含む）com.google.android.gms:play-services-auth-blockstore:16.4.0 |
スマートフォン、タブレット、Android Go、ChromeOS |
Google Awareness APIcom.google.android.gms:play-services-awareness:19.1.0 |
スマートフォン、タブレット、Auto、Android Go、ChromeOS |
ユーティリティ クラスcom.google.android.gms:play-services-base:18.9.0 |
スマートフォン、タブレット、Android TV、Auto、Android Go、ChromeOS、Wear OS |
ユーティリティ クラスのテスト用フェイクcom.google.android.gms:play-services-base-testing:16.2.0 |
スマートフォン、タブレット、Android TV、Auto、Android Go、ChromeOS、Wear OS |
その他のユーティリティ クラスcom.google.android.gms:play-services-basement:18.9.0 |
スマートフォン、タブレット、Android TV、Auto、Android Go、ChromeOS、Wear OS |
カメラのローライト ブーストcom.google.android.gms:play-services-camera-low-light-boost:16.0.1-beta06 |
スマートフォン、タブレット |
Google Castcom.google.android.gms:play-services-cast:22.2.0 |
スマートフォン、タブレット、Android Go、ChromeOS |
Google Cast Application Framework（CAF）com.google.android.gms:play-services-cast-framework:22.2.0 |
スマートフォン、タブレット、Android Go、ChromeOS |
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.1.1 |
スマートフォン、タブレット、Android TV、Auto、Android Go、ChromeOS、Wear OS |
デバイス間インタラクション（DTDI）com.google.android.gms:play-services-dtdi:16.0.0-beta02 |
スマートフォン、タブレット、Android Go |
Fast IDentity Online（FIDO）認証com.google.android.gms:play-services-fido:21.2.0 |
スマートフォン、タブレット、Android TV、Auto、Android Go、ChromeOS、Wear OS Android 7.0（API レベル 24）以上を搭載したデバイスでサポートされています。 |
Android 向け Google Fit API とモバイルの Recording API（ユーザーのフィットネス データ用）com.google.android.gms:play-services-fitness:21.3.0 |
スマートフォン、タブレット、Android Go、ChromeOS、Wear OS |
Android 向け Google Play Games サービス v2com.google.android.gms:play-services-games-v2:21.0.0 |
スマートフォン、タブレット、Android TV、Android Go、ChromeOS |
Google Play Games サービス v2 ネイティブ C SDK for Androidcom.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:24.0.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.2.0 |
非推奨。詳しくは、Google Play Instant をご覧ください。 |
Android の位置情報サービスcom.google.android.gms:play-services-location:21.3.0 |
スマートフォン、タブレット、Android TV、Auto、Android Go、ChromeOS、Wear OS |
Android 向け Google マップ SDKcom.google.android.gms:play-services-maps:19.2.0 |
スマートフォン、タブレット、Android TV、Auto、Android Go、ChromeOS、Wear OS |
Android 向け Google マップ 3D SDKcom.google.android.gms:play-services-maps3d:0.1.0 |
スマートフォン、タブレット |
ML Kit のバーコード スキャンcom.google.android.gms:play-services-mlkit-barcode-scanning:18.3.1 |
スマートフォン、タブレット、Android Go、ChromeOS |
ML Kit ドキュメント スキャナcom.google.android.gms:play-services-mlkit-document-scanner:16.0.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.1 |
スマートフォン、タブレット、Android Go、ChromeOS |
中国語の ML Kit テキスト認識com.google.android.gms:play-services-mlkit-text-recognition-chinese:16.0.1 |
スマートフォン、タブレット、Android Go、ChromeOS |
デーヴァナーガリー文字の ML Kit テキスト認識com.google.android.gms:play-services-mlkit-text-recognition-devanagari:16.0.1 |
スマートフォン、タブレット、Android Go、ChromeOS |
日本語の ML Kit テキスト認識com.google.android.gms:play-services-mlkit-text-recognition-japanese:16.0.1 |
スマートフォン、タブレット、Android Go、ChromeOS |
韓国語の ML Kit テキスト認識com.google.android.gms:play-services-mlkit-text-recognition-korean:16.0.1 |
スマートフォン、タブレット、Android Go、ChromeOS |
付近のデバイスの検出と接続com.google.android.gms:play-services-nearby:19.3.0 |
スマートフォン、タブレット、Android TV、Auto、Android Go |
オープンソース ライセンスを表示com.google.android.gms:play-services-oss-licenses:17.3.0 |
スマートフォン、タブレット、Android TV、Auto、Android Go、ChromeOS Android 5.0（API レベル 21）以上を搭載したデバイスでサポートされています。 |
プログラマティック アクセス ライブラリ（PAL）com.google.android.gms:play-services-pal:22.1.0 |
スマートフォン、タブレット、Android TV Android 5.0（API レベル 21）以上を搭載したデバイスでサポートされています。 |
画面ロックの品質チェック com.google.android.gms:play-services-password-complexity:18.1.0 |
スマートフォン、タブレット、Android Go、ChromeOS、Wear OS Android 4.4（API レベル 19）から Android 9（API レベル 28）を搭載したデバイスでサポートされています。 |
Google ウォレット（旧 Google Pay for Passes）com.google.android.gms:play-services-pay:16.5.0 |
スマートフォン、タブレット、Android Go、ChromeOS Android 5.0（API レベル 20）以上を搭載したデバイスでサポートされています。 |
アプリの計測用の reCAPTCHA Enterprisecom.google.android.gms:play-services-recaptcha:17.1.0 |
スマートフォン、タブレット、Android TV、Android Go、ChromeOS |
SafetyNet API（セーフ ブラウジングとアプリの確認を含む）com.google.android.gms:play-services-safetynet:18.1.0 |
スマートフォン、タブレット、Android TV、Auto、Android Go、ChromeOS |
Google タグ マネージャーcom.google.android.gms:play-services-tagmanager:18.3.0 |
スマートフォン、タブレット、Android TV、Android Go、ChromeOS |
Android 版 Tasks APIcom.google.android.gms:play-services-tasks:18.4.0 |
スマートフォン、タブレット、Android TV、Auto、Android Go、ChromeOS、Wear OS |
Android 向けアクセラレーション サービスcom.google.android.gms:play-services-tflite-acceleration-service:16.4.0-beta01 |
スマートフォン、タブレット、Android Go、ChromeOS |
Google Play 開発者サービス向けの TensorFlow Lite GPU Delegate APIcom.google.android.gms:play-services-tflite-gpu:16.4.0 |
スマートフォン、タブレット、Android Go、ChromeOS |
Google Play 開発者サービス用の TensorFlow Lite Java APIcom.google.android.gms:play-services-tflite-java:16.4.0 |
スマートフォン、タブレット、Android Go、ChromeOS |
Google Play 開発者サービス向けの TensorFlow Lite Support APIcom.google.android.gms:play-services-tflite-support:16.4.0 |
スマートフォン、タブレット、Android Go、ChromeOS |
Thread Network APIcom.google.android.gms:play-services-threadnetwork:16.3.0 |
スマートフォン、タブレット |
Trusted Time APIcom.google.android.gms:play-services-time:16.0.1 |
スマートフォン、タブレット、Auto、Android Go、Wear OS |
Mobile Visioncom.google.android.gms:play-services-vision:20.1.3 |
スマートフォン、タブレット、Android Go、ChromeOS |
Android での支払いのための Google Paycom.google.android.gms:play-services-wallet:19.5.0 |
スマートフォン、タブレット、Auto、Android Go、ChromeOS、Wear OS |
Wearable Data Layer APIcom.google.android.gms:play-services-wearable:19.0.0 |
スマートフォン、タブレット、Wear OS |
Gradle プラグイン
次の表に示すように、Google Play 開発者サービスには複数の Gradle プラグインも含まれています。前の表の前に表示されるボタンは、この表に表示される情報を変更しません。
| ユースケースと Gradle プラグインの名前 | サポートされているデバイス |
|---|---|
オープンソース ライセンスを表示com.google.android.gms:oss-licenses-plugin:0.10.9 |
スマートフォン、タブレット、ChromeOS |
厳密なバージョン チェックcom.google.android.gms:strict-version-matcher-plugin:1.2.4 |
スマートフォン、タブレット、Android TV、Auto、Android Go、ChromeOS、Wear OS |