このページは Cloud Translation API によって翻訳されました。

Google ログインを Android アプリに統合する

警告: Android 版 Google ログインは古いバージョンであり、サポートが終了しています。アプリのセキュリティとユーザビリティを継続的に確保するには、今すぐ認証情報マネージャーに移行してください。認証情報マネージャーは、パスキー、パスワード、フェデレーション ID 認証（Google でログインなど）をサポートし、セキュリティを強化し、ユーザーエクスペリエンスを一貫性のあるものにします。Wear デベロッパー向け: 認証情報マネージャーは、Wear OS 5.1 以降の一部のデバイスでサポートされます。「Google でログイン」を使用して Wear OS 3、4、5.0 デバイスを積極的にサポートしているデベロッパーは、Wear アプリで Android 向け Google ログインを引き続き使用する必要があります。「Google でログイン」のサポートは、これらのバージョンの Wear OS の認証情報マネージャー API で後日利用可能になります。

Google ログインを Android アプリに統合するには、Google ログインを構成し、ログインフローを開始するボタンをアプリのレイアウトに追加します。

始める前に

Google API Console プロジェクトを設定し、Android Studio プロジェクトをセットアップする。

Google ログインと GoogleSignInClient オブジェクトを構成する

ログインアクティビティの onCreate メソッドで、アプリで必要なユーザーデータをリクエストするように Google ログインを構成します。たとえば、ユーザーの ID と基本的なプロフィール情報をリクエストするように Google ログインを構成するには、DEFAULT_SIGN_IN パラメータを使用して GoogleSignInOptions オブジェクトを作成します。ユーザーのメールアドレスもリクエストするには、requestEmail オプションを使用して GoogleSignInOptions オブジェクトを作成します。
```
// Configure sign-in to request the user's ID, email address, and basic
// profile. ID and basic profile are included in DEFAULT_SIGN_IN.
GoogleSignInOptions gso = new GoogleSignInOptions.Builder(GoogleSignInOptions.DEFAULT_SIGN_IN)
        .requestEmail()
        .build();
```
Google API にアクセスするための追加のスコープをリクエストする必要がある場合は、requestScopes で指定します。ユーザーエクスペリエンスを最大限に高めるには、ログイン時に、アプリが最低限機能するために必要なスコープのみをリクエストします。追加のスコープは、必要な場合にのみリクエストしてください。そうすることで、ユーザーは、実行したアクションのコンテキストで同意画面を表示できます。追加スコープのリクエストをご覧ください。
次に、ログインアクティビティの onCreate メソッドでも、指定したオプションを使用して GoogleSignInClient オブジェクトを作成します。
```
// Build a GoogleSignInClient with the options specified by gso.
mGoogleSignInClient = GoogleSignIn.getClient(this, gso);
```

既存のログインユーザーを確認する

アクティビティの onStart メソッドで、ユーザーがすでに Google でアプリにログインしているかどうかを確認します。

// Check for existing Google Sign In account, if the user is already signed in
// the GoogleSignInAccount will be non-null.
GoogleSignInAccount account = GoogleSignIn.getLastSignedInAccount(this);
updateUI(account);

GoogleSignIn.getLastSignedInAccount が null ではなく GoogleSignInAccount オブジェクトを返す場合、ユーザーはすでに Google でアプリにログインしています。それに応じて UI を更新します。つまり、ログインボタンを非表示にしたり、メインアクティビティを起動したりします。アプリに適した方法で更新してください。

GoogleSignIn.getLastSignedInAccount が null を返した場合、ユーザーは Google でアプリにログインしていません。Google ログインボタンを表示するように UI を更新します。

Google ログインボタンをアプリに追加する

標準の Google ログインボタンアプリケーションのレイアウトに SignInButton を追加します。

<com.google.android.gms.common.SignInButton
 android:id="@+id/sign_in_button"
 android:layout_width="wrap_content"
 android:layout_height="wrap_content" />

省略可: 独自のログインボタンアセットを指定せずに、デフォルトのログインボタングラフィックを使用している場合は、setSize メソッドでボタンのサイズをカスタマイズできます。
```
// Set the dimensions of the sign-in button.
SignInButton signInButton = findViewById(R.id.sign_in_button);
signInButton.setSize(SignInButton.SIZE_STANDARD);
```
Android のアクティビティ（onCreate メソッド内のアクティビティなど）で、ボタンの OnClickListener を登録し、クリックされたときにユーザーがログインできるようにします。
```
findViewById(R.id.sign_in_button).setOnClickListener(this);
```

ログインフローを開始する

アクティビティの onClick メソッドで、getSignInIntent メソッドでログインインテントを作成し、startActivityForResult でインテントを開始することにより、ログインボタンのタップを処理します。
```
@Override
public void onClick(View v) {
    switch (v.getId()) {
        case R.id.sign_in_button:
            signIn();
            break;
        // ...
    }
}
```
```
private void signIn() {
    Intent signInIntent = mGoogleSignInClient.getSignInIntent();
    startActivityForResult(signInIntent, RC_SIGN_IN);
}
```
インテントを開始すると、ログインに使用する Google アカウントを選択するようユーザーに求めるプロンプトが表示されます。profile、email、openid 以外のスコープをリクエストした場合、ユーザーはそれらのリソースへのアクセスを許可するよう求められます。

ユーザーがログインすると、アクティビティの onActivityResult メソッドでユーザーの GoogleSignInAccount オブジェクトを取得できます。

@Override
public void onActivityResult(int requestCode, int resultCode, Intent data) {
    super.onActivityResult(requestCode, resultCode, data);

    // Result returned from launching the Intent from GoogleSignInClient.getSignInIntent(...);
    if (requestCode == RC_SIGN_IN) {
        // The Task returned from this call is always completed, no need to attach
        // a listener.
        Task<GoogleSignInAccount> task = GoogleSignIn.getSignedInAccountFromIntent(data);
        handleSignInResult(task);
    }
}

GoogleSignInAccount オブジェクトには、ログイン中のユーザーに関する情報（ユーザー名など）が含まれています。

private void handleSignInResult(Task<GoogleSignInAccount> completedTask) {
    try {
        GoogleSignInAccount account = completedTask.getResult(ApiException.class);

        // Signed in successfully, show authenticated UI.
        updateUI(account);
    } catch (ApiException e) {
        // The ApiException status code indicates the detailed failure reason.
        // Please refer to the GoogleSignInStatusCodes class reference for more information.
        Log.w(TAG, "signInResult:failed code=" + e.getStatusCode());
        updateUI(null);
    }
}

getEmail を使用してユーザーのメールアドレスを取得したり、getId を使用してユーザーの Google ID（クライアントサイドで使用）を取得したり、getIdToken を使用してユーザーの ID トークンを取得したりすることもできます。現在ログインしているユーザーをバックエンドサーバーに渡す必要がある場合は、ID トークンをバックエンドサーバーに送信し、サーバーでトークンを検証します。