Skip to content

Commit 65475f2

Browse files
JustinBeckwithchingor13
authored andcommitted
Update statement of support (#1158)
1 parent 0487d59 commit 65475f2

File tree

1 file changed

+44
-49
lines changed

1 file changed

+44
-49
lines changed

README.md

Lines changed: 44 additions & 49 deletions
Original file line numberDiff line numberDiff line change
@@ -11,12 +11,7 @@
1111
- [Links](#Links)
1212

1313
## Library maintenance
14-
15-
This client library is supported but in maintenance mode only. We are fixing necessary bugs and
16-
adding essential features to ensure this library continues to meet your needs for accessing Google
17-
APIs. Non-critical issues will be closed. Any issue may be reopened if it is causing ongoing problems.
18-
19-
If you're working with **Google Cloud Platform** APIs such as Datastore, Pub/Sub and many others,
14+
These client libraries are official supported by Google. However, these libraries are considered complete and are in maintenance mode. This means that we will address critical bugs and security issues but will not add any new features. If you're working with **Google Cloud Platform** APIs such as Datastore, Pub/Sub and many others,
2015
consider using the [Cloud Client Libraries for Java](https://github.com/GoogleCloudPlatform/google-cloud-java)
2116
instead. These are the new and idiomatic Java libraries targeted specifically at Google Cloud
2217
Platform Services.
@@ -58,38 +53,38 @@ The Google APIs Client Library for Java is a flexible, efficient, and powerful J
5853
for accessing any HTTP-based API on the web, not just Google APIs.
5954

6055
The library has the following features:
61-
- A powerful [OAuth 2.0](https://developers.google.com/api-client-library/java/google-api-java-client/oauth2) library with a consistent interface.
56+
- A powerful [OAuth 2.0](https://developers.google.com/api-client-library/java/google-api-java-client/oauth2) library with a consistent interface.
6257
- Lightweight, efficient XML and JSON data models that support any data schema.
6358
- Support for [protocol buffers](https://github.com/google/protobuf/).
64-
- A set of [generated libraries for Google APIs](https://developers.google.com/api-client-library/java/apis/).
59+
- A set of [generated libraries for Google APIs](https://developers.google.com/api-client-library/java/apis/).
6560

6661
### Accessing Google APIs
6762

6863
To use Google's Java client libraries to call any Google API, you need two libraries:
6964

70-
- The core Google APIs Client Library for Java (google-api-java-client), which is the generic
71-
runtime library described here. This library provides functionality common to all APIs, for example
72-
HTTP transport, error handling, authentication, JSON parsing, media download/upload, and batching.
73-
- An auto-generated Java library for the API you are accessing, for example
74-
the [generated Java library for the BigQuery API](https://github.com/google/google-api-java-client-samples/tree/master/bigquery-appengine-sample/src/main/java/com/google/api/client/sample/bigquery/appengine/dashboard).
75-
These generated libraries include API-specific information such as the root URL, and classes that
76-
represent entities in the context of the API. These classes are useful for making conversions
65+
- The core Google APIs Client Library for Java (google-api-java-client), which is the generic
66+
runtime library described here. This library provides functionality common to all APIs, for example
67+
HTTP transport, error handling, authentication, JSON parsing, media download/upload, and batching.
68+
- An auto-generated Java library for the API you are accessing, for example
69+
the [generated Java library for the BigQuery API](https://github.com/google/google-api-java-client-samples/tree/master/bigquery-appengine-sample/src/main/java/com/google/api/client/sample/bigquery/appengine/dashboard).
70+
These generated libraries include API-specific information such as the root URL, and classes that
71+
represent entities in the context of the API. These classes are useful for making conversions
7772
between JSON objects and Java objects.
7873

79-
To find the generated library for a Google API, visit [Google APIs Client Library for Java](https://developers.google.com/api-client-library/java/apis/).
80-
The API-specific Java packages include both the core google-api-java-client and the client-specific
81-
libraries.
74+
To find the generated library for a Google API, visit [Google APIs Client Library for Java](https://developers.google.com/api-client-library/java/apis/).
75+
The API-specific Java packages include both the core google-api-java-client and the client-specific
76+
libraries.
8277

8378
If you are using the old GData library, you need to
8479
[migrate](https://github.com/google/gdata-java-client/blob/wiki/MigratingToGoogleApiJavaClient.md).
8580

8681
### Developing for Android
8782

88-
If you are developing for Android and the Google API you want to use is included in the
89-
[Google Play Services library](https://developer.android.com/google/play-services/index.html), you
90-
should use that library for the best performance and experience.
83+
If you are developing for Android and the Google API you want to use is included in the
84+
[Google Play Services library](https://developer.android.com/google/play-services/index.html), you
85+
should use that library for the best performance and experience.
9186

92-
To access other Google APIs, you can use the Google APIs Client Library for Java, which supports
87+
To access other Google APIs, you can use the Google APIs Client Library for Java, which supports
9388
[Android 4.0 (Ice Cream Sandwich) (or higher)](https://developers.google.com/api-client-library/java/google-api-java-client/android).
9489

9590
### Other Java environments
@@ -102,21 +97,21 @@ To access other Google APIs, you can use the Google APIs Client Library for Java
10297

10398
- **The library makes it simple to call Google APIs.**
10499

105-
You can call Google APIs using Google service-specific generated libraries with the Google APIs
106-
Client Library for Java. Here's an example that makes a call to the
107-
[Google Calendar API](https://developers.google.com/google-apps/calendar/):
100+
You can call Google APIs using Google service-specific generated libraries with the Google APIs
101+
Client Library for Java. Here's an example that makes a call to the
102+
[Google Calendar API](https://developers.google.com/google-apps/calendar/):
108103

109104
```java
110105
// Show events on user's calendar.
111106
View.header("Show Calendars");
112107
CalendarList feed = client.calendarList().list().execute();
113-
View.display(feed);
108+
View.display(feed);
114109
```
115110

116111
- **The library makes authentication easier.**
117112

118-
The authentication library can reduce the amount of code needed to handle
119-
[OAuth 2.0](https://developers.google.com/api-client-library/java/google-api-java-client/oauth2),
113+
The authentication library can reduce the amount of code needed to handle
114+
[OAuth 2.0](https://developers.google.com/api-client-library/java/google-api-java-client/oauth2),
120115
and sometimes a few lines is all you need. For example:
121116

122117
```java
@@ -132,20 +127,20 @@ private static Credential authorize() throws Exception {
132127
.build();
133128
// authorize
134129
return new AuthorizationCodeInstalledApp(flow, new LocalServerReceiver()).authorize("user");
135-
}
130+
}
136131
```
137132

138133
- **The library makes batching and media upload/download easier.**
139134

140-
The library offers helper classes for
141-
[batching](https://developers.google.com/api-client-library/java/google-api-java-client/batch),
142-
[media upload](https://developers.google.com/api-client-library/java/google-api-java-client/media-upload),
135+
The library offers helper classes for
136+
[batching](https://developers.google.com/api-client-library/java/google-api-java-client/batch),
137+
[media upload](https://developers.google.com/api-client-library/java/google-api-java-client/media-upload),
143138
and [media download](https://developers.google.com/api-client-library/java/google-api-java-client/media-download).
144139

145140
- **The library runs on Google App Engine.**
146141

147-
[App Engine-specific helpers](https://developers.google.com/api-client-library/java/google-api-java-client/app-engine)
148-
make quick work of authenticated calls to APIs, and you do not need to worry about exchanging code for tokens.
142+
[App Engine-specific helpers](https://developers.google.com/api-client-library/java/google-api-java-client/app-engine)
143+
make quick work of authenticated calls to APIs, and you do not need to worry about exchanging code for tokens.
149144
For example:
150145

151146
```java
@@ -158,19 +153,19 @@ protected void doGet(HttpServletRequest req, HttpServletResponse resp) throws IO
158153
.build();
159154
UrlHistory history = shortener.URL().list().execute();
160155
...
161-
}
156+
}
162157
```
163158

164159
- **The library runs on [Android (@Beta)](#@Beta).**
165160

166-
If you are developing for Android and the Google API you want to use is included in the
167-
[Google Play Services library](https://developer.android.com/google/play-services/index.html),
168-
you should use that library for the best performance and experience.
161+
If you are developing for Android and the Google API you want to use is included in the
162+
[Google Play Services library](https://developer.android.com/google/play-services/index.html),
163+
you should use that library for the best performance and experience.
169164

170-
To access other Google APIs, you can use the Google Client Library for Java's Android-specific
171-
helper classes, which are are well-integrated with
172-
[Android AccountManager](http://developer.android.com/reference/android/accounts/AccountManager.html).
173-
For example:
165+
To access other Google APIs, you can use the Google Client Library for Java's Android-specific
166+
helper classes, which are are well-integrated with
167+
[Android AccountManager](http://developer.android.com/reference/android/accounts/AccountManager.html).
168+
For example:
174169

175170
```java
176171
@Override
@@ -185,13 +180,13 @@ public void onCreate(Bundle savedInstanceState) {
185180
service =
186181
new com.google.api.services.tasks.Tasks.Builder(httpTransport, jsonFactory, credential)
187182
.setApplicationName("Google-TasksAndroidSample/1.0").build();
188-
}
183+
}
189184
```
190185

191186
- **The library is easy to install.**
192187

193-
The Google APIs Client Library for Java is easy to install, and you can download the binary
194-
directly from the [Downloads page](https://developers.google.com/api-client-library/java/google-api-java-client/download),
188+
The Google APIs Client Library for Java is easy to install, and you can download the binary
189+
directly from the [Downloads page](https://developers.google.com/api-client-library/java/google-api-java-client/download),
195190
or you can use Maven or Gradle.
196191

197192
To use Maven, add the following lines to your pom.xml file:
@@ -205,8 +200,8 @@ To use Maven, add the following lines to your pom.xml file:
205200
<version>1.25.0</version>
206201
</dependency>
207202
</dependencies>
208-
</project>
209-
```
203+
</project>
204+
```
210205

211206
To use Gradle, add the following lines to your build.gradle file:
212207

@@ -220,8 +215,8 @@ dependencies {
220215
```
221216

222217
## Dependencies
223-
This library is built on top of two common libraries, also built by Google, and also designed to
224-
work with any HTTP service on the web:
218+
This library is built on top of two common libraries, also built by Google, and also designed to
219+
work with any HTTP service on the web:
225220

226221
- [Google HTTP Client Library for Java](https://github.com/google/google-http-java-client)
227222
- [Google OAuth Client Library for Java](https://github.com/google/google-oauth-java-client)

0 commit comments

Comments
 (0)