java.lang.Object | |
↳ | com.google.android.gms.common.ConnectionResult |
Contains all possible error codes for when a client fails to connect to Google Play services.
These error codes are used by
GoogleApiClient.OnConnectionFailedListener
.
Constants | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|
int | API_UNAVAILABLE | One of the API components you attempted to connect to is not available. | |||||||||
int | CANCELED | The connection was canceled. | |||||||||
int | DEVELOPER_ERROR | The application is misconfigured. | |||||||||
int | DRIVE_EXTERNAL_STORAGE_REQUIRED | This constant is deprecated. External storage is no longer required. | |||||||||
int | INTERNAL_ERROR | An internal error occurred. | |||||||||
int | INTERRUPTED | An interrupt occurred while waiting for the connection complete. | |||||||||
int | INVALID_ACCOUNT | The client attempted to connect to the service with an invalid account name specified. | |||||||||
int | LICENSE_CHECK_FAILED | The application is not licensed to the user. | |||||||||
int | NETWORK_ERROR | A network error occurred. | |||||||||
int | RESOLUTION_REQUIRED | Completing the connection requires some form of resolution. | |||||||||
int | RESTRICTED_PROFILE | The current user profile is restricted and cannot use authenticated features. | |||||||||
int | SERVICE_DISABLED | The installed version of Google Play services has been disabled on this device. | |||||||||
int | SERVICE_INVALID | The version of the Google Play services installed on this device is not authentic. | |||||||||
int | SERVICE_MISSING | Google Play services is missing on this device. | |||||||||
int | SERVICE_MISSING_PERMISSION | Google Play service doesn't have one or more required permissions. | |||||||||
int | SERVICE_UPDATING | Google Play service is currently being updated on this device. | |||||||||
int | SERVICE_VERSION_UPDATE_REQUIRED | The installed version of Google Play services is out of date. | |||||||||
int | SIGN_IN_FAILED | The client attempted to connect to the service but the user is not signed in. | |||||||||
int | SIGN_IN_REQUIRED | The client attempted to connect to the service but the user is not signed in. | |||||||||
int | SUCCESS | The connection was successful. | |||||||||
int | TIMEOUT | The timeout was exceeded while waiting for the connection to complete. |
[Expand]
Inherited Constants | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|
![]() |
Fields | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|
CREATOR |
Public Constructors | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|
Creates a connection result.
| |||||||||||
Creates a connection result.
| |||||||||||
Creates a connection result.
|
Public Methods | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|
Indicates the type of error that interrupted connection.
| |||||||||||
Returns an error message for connection result.
| |||||||||||
A pending intent to resolve the connection failure.
| |||||||||||
Returns true if calling
startResolutionForResult(Activity, int)
will start any intents requiring user interaction. | |||||||||||
Returns true if the connection was successful.
| |||||||||||
Resolves an error by starting any intents requiring user
interaction.
| |||||||||||
[Expand]
Inherited Methods | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|
![]() | |||||||||||
![]() |
One of the API components you attempted to connect to is not available. The API will not work on this device or for your app or for this particular account, and updating Google Play services will not likely solve the problem.
The connection was canceled. This is returned in two situations:
blockingConnect()
when
disconnect()
is called before the
connection completes.
enableAutoManage(FragmentActivity, GoogleApiClient.OnConnectionFailedListener)
when the
user choses not to complete a provided resolution. For example by canceling a dialog.
The application is misconfigured. This error is not recoverable and will be treated as fatal. The developer should look at the logs after this to determine more actionable information.
This constant is deprecated.
External storage is no longer required.
The Drive API requires external storage (such as an SD card), but no external storage is mounted. This error is recoverable if the user installs external storage (if none is present) and ensures that it is mounted (which may involve disabling USB storage mode, formatting the storage, or other initialization as required by the device).
This error should never be returned on a device with emulated external storage. On devices with emulated external storage, the emulated "external storage" is always present regardless of whether the device also has removable storage.
An internal error occurred. Retrying should resolve the problem.
An interrupt occurred while waiting for the connection complete. Only returned by
blockingConnect()
.
The client attempted to connect to the service with an invalid account name specified.
The application is not licensed to the user. This error is not recoverable and will be treated as fatal.
A network error occurred. Retrying should resolve the problem.
Completing the connection requires some form of resolution. A resolution will be available
to be started with startResolutionForResult(Activity, int)
.
If the result returned is RESULT_OK
, then further attempts to connect
should either complete or continue on to the next issue that needs to be resolved.
The current user profile is restricted and cannot use authenticated features. (Jelly Bean MR2+ Restricted Profiles for Android tablets)
The installed version of Google Play services has been disabled on this device.
The calling activity should pass this error code to
getErrorDialog(Activity, int, int)
to get a localized error dialog
that will resolve the error when shown.
The version of the Google Play services installed on this device is not authentic.
Google Play services is missing on this device.
The calling activity should pass this error code to
getErrorDialog(Activity, int, int)
to get a localized error dialog
that will resolve the error when shown.
Google Play service doesn't have one or more required permissions. The client may call
startResolutionForResult(Activity, int)
to prompt the user to
fix the issue. After activity returns with RESULT_OK
further attempts to
connect should succeed.
Google Play service is currently being updated on this device.
The installed version of Google Play services is out of date.
The calling activity should pass this error code to
getErrorDialog(Activity, int, int)
to get a localized error dialog
that will resolve the error when shown.
The client attempted to connect to the service but the user is not signed in. An error may
have occurred when signing in the user and the error can not be recovered with any user
interaction. Alternately, the API may have been requested with
addApiIfAvailable(Api extends Api.ApiOptions.NotRequiredOptions>, Scope...)
and
it may be the case that no required APIs needed authentication, so authentication did not
occur.
When seeing this error code,there is no resolution for the sign-in failure.
The client attempted to connect to the service but the user is not
signed in. The client may choose to continue without using the API. Alternately, if
hasResolution()
returns true the client may call
startResolutionForResult(Activity, int)
to prompt the user to sign
in. After the sign in activity returns with RESULT_OK
further attempts
should succeed.
The connection was successful.
The timeout was exceeded while waiting for the connection to complete. Only returned by
blockingConnect()
.
Creates a connection result.
Parameters | |
---|---|
statusCode |
int :
The status code.
|
Creates a connection result.
Parameters | |
---|---|
statusCode |
int :
The status code. |
pendingIntent |
PendingIntent :
A pending intent that will resolve the issue when started, or null.
|
Creates a connection result.
Parameters | |
---|---|
statusCode |
int :
The status code. |
pendingIntent |
PendingIntent :
A pending intent that will resolve the issue when started, or null. |
message |
String :
An additional error message for the connection result, or null.
|
Parameters | |
---|---|
o |
Object
|
Returns | |
---|---|
boolean |
Indicates the type of error that interrupted connection.
Returns | |
---|---|
int |
the error code, or SUCCESS if no error occurred.
|
Returns an error message for connection result.
Returns | |
---|---|
String |
the message. |
A pending intent to resolve the connection failure. This intent can be started with
startIntentSenderForResult(IntentSender, int, Intent, int, int, int)
to present UI to solve the issue.
Returns | |
---|---|
PendingIntent |
The pending intent to resolve the connection failure. |
Returns true if calling startResolutionForResult(Activity, int)
will start any intents requiring user interaction.
Returns | |
---|---|
boolean |
true if there is a resolution that can be started. |
Returns | |
---|---|
int |
Returns true if the connection was successful.
Returns | |
---|---|
boolean |
true if the connection was successful, false if there was an error. |
Resolves an error by starting any intents requiring user
interaction. See SIGN_IN_REQUIRED
, and
RESOLUTION_REQUIRED
.
Parameters | |
---|---|
activity |
Activity :
An Activity context to use to resolve the issue. The activity's
onActivityResult method will be invoked after the user is done. If the
resultCode is RESULT_OK , the application should try to
connect again. |
requestCode |
int :
The request code to pass to onActivityResult. |
Throws | |
---|---|
IntentSender.SendIntentException |
If the resolution intent has been canceled or is no longer able to execute the request. |
Returns | |
---|---|
String |
Parameters | |
---|---|
out |
Parcel
|
flags |
int
|