SearchAuthApi

public interfaceSearchAuthApi

API for Google Search auth.

Usage example:

{@code
SearchAuthApi searchAuthApi = SearchAuth.SearchAuthApi;
GoogleApiClient client = new GoogleApiClient.Builder(context)
.addApi(SearchAuth.API)
.build();
client.connect();

try {
// Invoke methods of searchAuthApi.
} finally {
client.disconnect();
}
}

Nested Class Summary

interface SearchAuthApi.GoogleNowAuthResult Result of SearchAuthApi.getGoogleNowAuth(GoogleApiClient, String).

Public Method Summary

abstractPendingResult<Status>
clearToken(GoogleApiClient client,StringaccessToken)
Clears an access token from the cache.
abstractPendingResult<SearchAuthApi.GoogleNowAuthResult>
getGoogleNowAuth(GoogleApiClient client,String webAppClientId)
Obtains authorization for the caller to use the Now API to publish to the Google Now user, if any, on this device.

Public Methods

public abstractPendingResult<Status> clearToken(GoogleApiClient client,String accessToken)

Clears an access token from the cache. Use this to remove revoked access tokens from the cache before calling getGoogleNowAuth(GoogleApiClient, String)to obtain new authorization.

Parameters
client GoogleApiClient that includesSearchAuth.API.
accessToken the access token to be cleared from the cache.
Returns

public abstractPendingResult<SearchAuthApi.GoogleNowAuthResult> getGoogleNowAuth(GoogleApiClient client,String webAppClientId)

Obtains authorization for the caller to use the Now API to publish to the Google Now user, if any, on this device.

Access tokens returned by this method are cached. If the token is revoked later, on the server, either by the developer or the user, this method will continue returning that access token from the cache until the cache entry expires. Using a revoked access token in Google Now APIs will result in an error like "invalid_token", "Token expired or revoked", "Invalid Credentials", etc. In such cases the revoked access token must be removed from the cache using clearToken(GoogleApiClient, String)before this method is called to obtain new authorization.

Usage example:

{@code
SearchAuthApi.GoogleNowAuthResult authResult;
try {
authResult = searchAuthApi.getGoogleNowAuth(client, WEB_APP_CLIENT_ID)
.await();
} finally {
client.disconnect();
}

Status status = authResult.getStatus();
if (status.isSuccess()) {
GoogleNowAuthState authState = authResult.getGoogleNowAuthState();
if (authState.getAuthCode()!= null) {
// Send auth code to your server and from your server obtain OAuth refresh
// and access tokens.
} else if (authState.getAccessToken()!= null) {
// Already obtained auth code before. To get a new auth code revoke this
// token and retry.
}
}
}
Parameters
client GoogleApiClient that includesSearchAuth.API.
webAppClientId Client ID, in the Google Developer Console, of the web application that will be using the Now API.
Returns