[この記事は Laurence Moroney 、デベロッパー アドボケートによる Android Developers Blog の記事 "Using Credentials between your Server and Google Services " を元に翻訳・加筆したものです。詳しくは元記事をご覧ください。]
ユーザー エクスペリエンスの改善 に関する記事から始まりました。第 2 回の記事では、プログラミング モデルをより簡単にする、API の更新 について取り上げました。また、前回第 3 回の記事では、バックエンドのサーバーで Google Sign-In を使ってユーザーを認証する方法 をご紹介しました。
ベストプラクティス に従い、ユーザーが実行するアクションの最中（たとえば、オーダーした食事がテーブルに届き、アプリのユーザーが Google ドライブに保存するために写真を撮ろうとしたタイミング）に要求します。このタイミングでスコープを要求することで、アクセスが許可される可能性が最も高くなり、Android Marshmallow 6.0 のランタイム パーミッション モデル とも一致します。
図 1. クレデンシャルを使った Google サービスへのアクセス
ステップ 1 : サーバー認証のシナリオは第 3 回 の記事で説明したので、このサンプル では Android アプリの標準的なコードを示します。特に ServerAuthCodeActivity に注目してください。 GoogleSignInOptions gso = new GoogleSignInOptions.Builder(GoogleSignInOptions.DEFAULT_SIGN_IN)
.requestScopes(new Scope(Scopes.DRIVE_APPFOLDER))
// The serverClientId is an OAuth 2.0 web client ID
// Details at: https://developers.google.com/identity/sign-in/android/?utm_campaign=android_discussion_server_021116&utm_source=anddev&utm_medium=blogstart step 4
.requestServerAuthCode(serverClientId)
.requestEmail()
.build();
実行するには、サーバーのウェブ クライアント ID が必要になります。取得方法についての詳細は、こちら をご覧ください（ステップ 4 を参照）。
if (result.isSuccess()) {
GoogleSignInAccount acct = result.getSignInAccount();
String authCode = acct.getServerAuthCode();
}
ここ で示したサンプルの onActivityResult からの引用です）
ステップ 2 : GoogleAuthorizationCodeTokenRequest クラスを使い、サーバー上で Auth Code を Token と交換します。
// Set path to the Web application client_secret_*.json file you downloaded from the
// Google Developers Console: https://console.developers.google.com/project/_/apiui/credential
// You can also find your Web application client ID and client secret from the
// console and specify them directly when you create the GoogleAuthorizationCodeTokenRequest
// object.
String CLIENT_SECRET_FILE = "/path/to/client_secret.json" ; // Be careful not to share this!
String REDIRECT_URI = "/path/to/web_app_redirect" // Can be empty if you don’t use web redirects
// Exchange auth code for access token
GoogleClientSecrets clientSecrets =
GoogleClientSecrets .load(
JacksonFactory .getDefaultInstance(), new FileReader (CLIENT_SECRET_FILE));
GoogleTokenResponse tokenResponse =
new GoogleAuthorizationCodeTokenRequest (
new NetHttpTransport (),
JacksonFactory .getDefaultInstance(),
"https://www.googleapis.com/oauth2/v4/token" ,
clientSecrets.getDetails().getClientId(),
clientSecrets.getDetails().getClientSecret(),
authCode,
REDIRECT_URI)
.execute();
String accessToken = tokenResponse.getAccessToken();
String refreshToken = tokenResponse.getRefreshToken();
Long expiresInSeconds = tokenResponse.getExpiresInSeconds();
// You can also get an ID token from the exchange result if basic profile scopes are requested
// e.g. starting GoogleSignInOptions.Builder from GoogleSignInOptions.DEFAULT_SIGN_IN like the
// sample code as used here: http://goo.gl/0Unpq8
//
// GoogleIdToken googleIdToken = tokenResponse.parseIdToken();
GoogleCredential オブジェクトを作成します。
GoogleCredential credential = new GoogleCredential .Builder ()
.setTransport(new NetHttpTransport ())
.setJsonFactory(JacksonFactory .getDefaultInstance())
.setClientSecrets(clientSecrets)
.build();
credential.setAccessToken(accessToken);
credential.setExpiresInSeconds(expiresInSeconds);
credential.setRefreshToken(refreshToken);
StoredCredential を使って資格情報を保存し、再利用することができます。
ステップ 3: 取得した資格情報を使って、Google サービスにアクセスします。先ほどから挙げている食事のシナリオでいえば、運ばれてきた料理やレシートの写真を Google ドライブに保存したり、そこから取り出したりすることができます。これを行うには、たとえば次のようなコードを記述します。
Drive drive = new Drive .Builder (new NetHttpTransport (),
JacksonFactory .getDefaultInstance(),
credential)
.setApplicationName("Auth Code Exchange Demo" )
.build();
File file = drive.files().get ("appfolder" ).execute();
Google Identity Platform ウェブサイトにアクセスしてください。
Eiji Kitamura - Developer Relations Team