Google Play 開発者サービスをセットアップする

Google Play 開発者サービス API を使用してアプリを開発するには、このページの手順に沿って、関連する SDK を使用してプロジェクトを設定します。これらの SDK は Google Maven リポジトリから入手できます。

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 に依存する機能を開発するには、次の手順を行います。

  1. アプリのモジュール ディレクトリにある build.gradle ファイルを開きます。

  2. アプリに必要な SDK ごとに、その SDK の依存関係を含めます。このページには、Android アプリの一般的な Google Play 開発者サービスの依存関係を示すセクションがあります。Firebase の依存関係をプロジェクトに追加することもできます。

  3. 変更を保存して、プロジェクトを同期します。

次のスニペットは、位置情報ライブラリを使用する 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 開発者サービスの概要で説明されているように、Google Play 開発者サービスは、Android 6.0(API レベル 23)以降では 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 開発者サービスの依存関係を示します。いずれかのボタンを選択すると、デバイスの種類でリストをフィルタできます。また、ボタンの後に表示されるボックスにテキストを入力すると、特定のユースケースまたは依存関係の名前を検索できます。

表 1. Android アプリに含める Google Play 開発者サービスの依存関係
ユースケースと依存関係の名前 サポートされているデバイス
Google モバイル広告
com.google.android.gms:play-services-ads:23.6.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:23.6.0
スマートフォン、タブレット
検索向け AdSense(AFS)カスタム検索広告(CSA)
com.google.android.gms:play-services-afs-native:19.1.0
スマートフォン、タブレット、ChromeOS
Android 向け Google アナリティクス開発者サービス SDK
com.google.android.gms:play-services-analytics:18.1.1
非推奨。代わりに Firebase 向け Google アナリティクスを使用してください。
アプリ インデックス
com.google.android.gms:play-services-appindex:16.2.0
スマートフォン、タブレット、Android TV
AppSearch
com.google.android.gms:play-services-appsearch:16.0.1
スマートフォン、タブレット、Android TV
Android アプリセット ID
com.google.android.gms:play-services-appset:16.1.0
スマートフォン、タブレット、Android TV、ChromeOS
Android 版 Google ログイン
com.google.android.gms:play-services-auth:21.3.0
スマートフォン、タブレット、Android TV、Auto、Android Go、ChromeOS
SMS Retriever API
com.google.android.gms:play-services-auth-api-phone:18.1.0
スマートフォン、タブレット、Android Go
Block Store API(ユーザー認証情報ストレージを含む)
com.google.android.gms:play-services-auth-blockstore:16.4.0
スマートフォン、タブレット、Android Go、ChromeOS
Google Awareness API
com.google.android.gms:play-services-awareness:19.1.0
スマートフォン、タブレット、自動車、Android Go、ChromeOS
ユーティリティ クラス
com.google.android.gms:play-services-base:18.5.0
スマートフォン、タブレット、Android TV、Auto、Android Go、ChromeOS、Wear OS
ユーティリティ クラスのフェイクのテスト
com.google.android.gms:play-services-base-testing:16.1.0
スマートフォン、タブレット、Android TV、Auto、Android Go、ChromeOS、Wear OS
その他のユーティリティ クラス
com.google.android.gms:play-services-basement:18.5.0
スマートフォン、タブレット、Android TV、Auto、Android Go、ChromeOS、Wear OS
Google Cast
com.google.android.gms:play-services-cast:22.0.0
スマートフォン、タブレット、Android Go、ChromeOS
Google Cast アプリケーション フレームワーク(CAF)
com.google.android.gms:play-services-cast-framework:22.0.0
スマートフォン、タブレット、Android Go、ChromeOS
Google Code Scanner
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.0
スマートフォン、タブレット、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.1.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.2.0
スマートフォン、タブレット、Android Go、ChromeOS、Wear OS
Android 版 Google Play Games サービス v2
com.google.android.gms:play-services-games-v2:20.1.2
スマートフォン、タブレット、Android TV、Android Go、ChromeOS
Google Play Games サービス v2 ネイティブ C SDK for Android
com.google.android.gms:play-services-games-v2-native-c:17.0.0-beta1
スマートフォン、タブレット、Android TV、Android Go、ChromeOS
Android 向け Google Play Games サービス v1
com.google.android.gms:play-services-games:23.2.0
スマートフォン、タブレット、Android TV、Android Go、ChromeOS
Matter API
com.google.android.gms:play-services-home:16.0.0
スマートフォン、タブレット
Google Play Instant
com.google.android.gms:play-services-instantapps:18.1.0
スマートフォン、タブレット、Android TV、Android Go、ChromeOS

Android 5.0(API レベル 21)以降を搭載したデバイスでサポートされています。
Android 向け位置情報サービス
com.google.android.gms:play-services-location:21.3.0
スマートフォン、タブレット、Android TV、Auto、Android Go、ChromeOS、Wear OS
Google Maps SDK for Android
com.google.android.gms:play-services-maps:19.0.0
スマートフォン、タブレット、Android TV、Auto、Android Go、ChromeOS、Wear OS
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-beta1
スマートフォン、タブレット、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.1.0
スマートフォン、タブレット、Android TV、Auto、Android Go、ChromeOS
Android 5.0(API レベル 21)以降を搭載したデバイスでサポートされています。
Programmatic Access Library(PAL)
com.google.android.gms:play-services-pal:21.0.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 Enterprise
com.google.android.gms:play-services-recaptcha:17.1.0
スマートフォン、タブレット、Android TV、Android Go、ChromeOS
SafetyNet API(デバイス認証、セーフ ブラウジング、reCAPTCHA、アプリの検証を含む)
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.1.1
スマートフォン、タブレット、Android TV、Android Go、ChromeOS
Android 版 Tasks API
com.google.android.gms:play-services-tasks:18.2.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 API
com.google.android.gms:play-services-tflite-gpu:16.4.0
スマートフォン、タブレット、Android Go、ChromeOS
Google Play 開発者サービス向け TensorFlow Lite Java API
com.google.android.gms:play-services-tflite-java:16.4.0
スマートフォン、タブレット、Android Go、ChromeOS
Google Play 開発者サービスの TensorFlow Lite Support API
com.google.android.gms:play-services-tflite-support:16.4.0
スマートフォン、タブレット、Android Go、ChromeOS
Thread Network API
com.google.android.gms:play-services-threadnetwork:16.2.1
スマートフォン、タブレット
Trusted Time API
com.google.android.gms:play-services-time:16.0.0
スマートフォン、タブレット、Auto、Android Go、Wear OS
モバイル ビジョン
com.google.android.gms:play-services-vision:20.1.3
スマートフォン、タブレット、Android Go、ChromeOS
Android での支払い用の Google Pay
com.google.android.gms:play-services-wallet:19.4.0
スマートフォン、タブレット、Auto、Android Go、ChromeOS、Wear OS
Wearable Data Layer API
com.google.android.gms:play-services-wearable:19.0.0
スマートフォン、タブレット、Wear OS

Gradle プラグイン

Google Play 開発者サービスには、次の表に示すように、いくつかの Gradle プラグインも含まれています。前の表の前に表示されるボタンで、この表に表示される情報は変更されません。

表 2. 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