Timeouts and Errors
Stay organized with collections
Save and categorize content based on your preferences.
This document describes how to set timeouts and handle HTTP errors that your code
might receive when you use the Google API Client Library for Java.
Contents
Setting timeouts
In the following example, which uses the Google Analytics API
, the setConnectTimeout
and setReadTimeout
methods are used to set the connect and
read timeouts to three minutes (in milliseconds) for all requests:
private
HttpRequestInitializer
setHttpTimeout
(
final
HttpRequestInitializer
requestInitializer
)
{
return
new
HttpRequestInitializer
()
{
@Override
public
void
initialize
(
HttpRequest
httpRequest
)
throws
IOException
{
requestInitializer
.
initialize
(
httpRequest
);
httpRequest
.
setConnectTimeout
(
3
*
60000
);
// 3 minutes connect timeout
httpRequest
.
setReadTimeout
(
3
*
60000
);
// 3 minutes read timeout
}
};
GoogleCredential
credential
=
....
final
Analytics
analytics
=
Analytics
.
builder
(
new
NetHttpTransport
(),
jsonFactory
,
setHttpTimeout
(
credential
)).
build
();
Handling HTTP error responses from Google APIs
When an error status code is detected in an HTTP response to a Google API that
uses the JSON format, the generated libraries throw a GoogleJsonResponseException
.
The errors use the format specified in Error responses
.
The following example shows one way that you can handle these exceptions:
Drive
.
Files
.
List
listFiles
=
drive
.
files
.
list
();
try
{
FileList
response
=
listFiles
.
execute
();
...
}
catch
(
GoogleJsonResponseException
e
)
{
System
.
err
.
println
(
e
.
getDetails
());
}
Except as otherwise noted, the content of this page is licensed under the Creative Commons Attribution 4.0 License
, and code samples are licensed under the Apache 2.0 License
. For details, see the Google Developers Site Policies
. Java is a registered trademark of Oracle and/or its affiliates.
Last updated 2025-08-28 UTC.
[[["Easy to understand","easyToUnderstand","thumb-up"],["Solved my problem","solvedMyProblem","thumb-up"],["Other","otherUp","thumb-up"]],[["Missing the information I need","missingTheInformationINeed","thumb-down"],["Too complicated / too many steps","tooComplicatedTooManySteps","thumb-down"],["Out of date","outOfDate","thumb-down"],["Samples / code issue","samplesCodeIssue","thumb-down"],["Other","otherDown","thumb-down"]],["Last updated 2025-08-28 UTC."],[[["\u003cp\u003eThis guide explains how to configure timeout settings for HTTP requests when using the Google API Client Library for Java, ensuring your application handles potential delays.\u003c/p\u003e\n"],["\u003cp\u003eIt demonstrates how to catch and manage HTTP error responses, specifically \u003ccode\u003eGoogleJsonResponseException\u003c/code\u003e, which occur when interacting with Google APIs.\u003c/p\u003e\n"],["\u003cp\u003eThe content provides code examples for setting connection and read timeouts and illustrates how to handle errors using try-catch blocks with \u003ccode\u003eGoogleJsonResponseException\u003c/code\u003e.\u003c/p\u003e\n"]]],[],null,["# Timeouts and Errors\n\nThis document describes how to set timeouts and handle HTTP errors that your code\nmight receive when you use the Google API Client Library for Java.\n\nContents\n--------\n\nSetting timeouts\n----------------\n\nIn the following example, which uses the [Google Analytics API](https://developers.google.com/api-client-library/java/apis/analytics/v3), the\n`setConnectTimeout` and `setReadTimeout` methods are used to set the connect and\nread timeouts to three minutes (in milliseconds) for all requests: \n\n private HttpRequestInitializer setHttpTimeout(final HttpRequestInitializer requestInitializer) {\n return new HttpRequestInitializer() {\n @Override\n public void initialize(HttpRequest httpRequest) throws IOException {\n requestInitializer.initialize(httpRequest);\n httpRequest.setConnectTimeout(3 * 60000); // 3 minutes connect timeout\n httpRequest.setReadTimeout(3 * 60000); // 3 minutes read timeout\n }\n };\n\n GoogleCredential credential = ....\n\n final Analytics analytics = Analytics.builder(new NetHttpTransport(), jsonFactory, setHttpTimeout(credential)).build();\n\nHandling HTTP error responses from Google APIs\n----------------------------------------------\n\nWhen an error status code is detected in an HTTP response to a Google API that\nuses the JSON format, the generated libraries throw a [GoogleJsonResponseException](https://googleapis.dev/java/google-api-client/latest/com/google/api/client/googleapis/json/GoogleJsonResponseException.html).\n\nThe errors use the format specified in [Error responses](https://cloud.google.com/apis/design/errors).\n\nThe following example shows one way that you can handle these exceptions: \n\n Drive.Files.List listFiles = drive.files.list();\n try {\n FileList response = listFiles.execute();\n ...\n } catch (GoogleJsonResponseException e) {\n System.err.println(e.getDetails());\n }"]]
