GoogleApiClient

If authenticated APIs are present they will attempt to connect, but failure of an authenticated API will not cause the GoogleApiClient connection to fail. After onConnected(Bundle) is received, the status of an authenticated API can be checked with hasConnectedApi(Api).

A GoogleApiClient using this mode may be transitioned between authenticated and unauthenticated states by adding GOOGLE_SIGN_IN_API and using GoogleSignInApi. To get an Intent that will allow the user to sign-in, call getSignInIntent(GoogleApiClient). To sign the user out, call signOut(GoogleApiClient).

It is an error to call connect() with no arguments on a client in this mode.

If a required authenticated API fails to connect, the entire GoogleApiClient will fail to connect and a failed ConnectionResult will be delivered to onConnectionFailed(ConnectionResult). Once a connection has successfully completed the only way to disconnect the authenticated APIs is to call disconnect() on this GoogleApiClient.

Using this mode is equivalent to calling connect() on a GoogleApiClient that contains authenticated APIs.

It is an error to use this mode if no authenticated APIs have been added to this GoogleApiClient.

Connects the client to Google Play services. Blocks until the connection either succeeds or fails. This is not allowed on the UI thread.

If the client is already connected, this methods returns immediately. If the client is already connecting (for example due to a prior call to connect()), this method blocks until the existing connection attempt completes. If a prior connection attempt has already failed, then a new connection attempt is started.

Connects the client to Google Play services. Blocks until the connection either succeeds or fails, or the timeout is reached.

If the client is already connected, this methods returns immediately. If the client is already connecting (for example due to a prior call to connect()), this method blocks until the existing connection attempt completes or the timeout is reached. If a prior connection attempt has already failed, then a new connection attempt is started.

Clears the account selected by the user and reconnects the client asking the user to pick an account again if useDefaultAccount() was set.

Connects the client to Google Play services using the given sign in mode.

It is an error to make multiple calls to this method passing different modes. Once a mode is selected, all future connect calls must use the same mode.

Connects the client to Google Play services. This method returns immediately, and connects to the service in the background. If the connection is successful, onConnected(Bundle) is called and enqueued items are executed. On a failure, onConnectionFailed(ConnectionResult) is called.

If the client is already connected or connecting, this method does nothing.

Closes the connection to Google Play services. No calls can be made using this client after calling this method. Any method calls that haven't executed yet will be canceled, and their onResult(Result) callbacks won't be called.

If the connection to the remote service hasn't been established yet, all enqueued calls will be canceled.

Prints the GoogleApiClient's state into the given stream.

Prints the state of all GoogleApiClients in the current process into the given stream.

This can be used to diagnose lifecycle issues where GoogleApiClients may be unintentionally left in the connected state. Note that the output may include clients that are no longer referenced but have not yet been garbage collected.

Returns the ConnectionResult for the GoogleApiClient's connection to the specified API. This method must only be called after connect() has been called and before disconnect() is called.

This method may return stale results if the GoogleApiClient is reconnecting due to a lost network connection. It is guaranteed to return the most recent ConnectionResult from attempting to connect the given API, but will throw an IllegalStateException if called before calling connect, after calling disconnect, or after receiving onConnectionFailed(ConnectionResult). This method can be used to easily determine why an API failed to connect if it was not available. To determine whether a given API is currently connected (without potential stale results) see hasConnectedApi(Api).

Returns whether or not this GoogleApiClient has the specified API in a connected state.

Checks if the client is currently connected to the service, so that requests to other methods will succeed. Applications should guard client actions caused by the user with a call to this method.

Checks if the client is attempting to connect to the service.

Returns true if the specified listener is currently registered to receive connection events.

Returns true if the specified listener is currently registered to receive connection failed events.

Closes the current connection to Google Play services and creates a new connection. Equivalent to calling disconnect() followed by connect().

This method closes the current connection then returns immediately and reconnects to the service in the background.

After calling this method, your application will receive onConnected(Bundle) if the connection is successful, or onConnectionFailed(ConnectionResult) if the connection failed.

Registers a listener to receive connection events from this GoogleApiClient. If the service is already connected, the listener's onConnected(Bundle) method will be called immediately. Applications should balance calls to this method with calls to unregisterConnectionCallbacks(ConnectionCallbacks) to avoid leaking resources.

If the specified listener is already registered to receive connection events, this method will not add a duplicate entry for the same listener, but will still call the listener's onConnected(Bundle) method if currently connected.

Note that the order of messages received here may not be stable, so clients should not rely on the order that multiple listeners receive events in.

Registers a listener to receive connection failed events from this GoogleApiClient. Unlike registerConnectionCallbacks(GoogleApiClient.ConnectionCallbacks), if the service is not already connected, the listener's onConnectionFailed(ConnectionResult) method will not be called immediately. Applications should balance calls to this method with calls to unregisterConnectionFailedListener(OnConnectionFailedListener) to avoid leaking resources.

If the specified listener is already registered to receive connection failed events, this method will not add a duplicate entry for the same listener.

Note that the order of messages received here may not be stable, so clients should not rely on the order that multiple listeners receive events in.

Disconnects the client and stops automatic lifecycle management. Use this before creating a new client (which might be necessary when switching accounts, changing the set of used APIs etc.).

This method must be called from the main thread.

Removes a connection listener from this GoogleApiClient. Note that removing a listener does not generate any callbacks.

If the specified listener is not currently registered to receive connection events, this method will have no effect.

Removes a connection failed listener from the GoogleApiClient. Note that removing a listener does not generate any callbacks.

If the specified listener is not currently registered to receive connection failed events, this method will have no effect.