Release google-api-java-client v1.30.0 (#1327)

chingor13 · web-flow · commit d0e16fd50082 · 2019-06-18T09:34:09.000-07:00
* Release v1.30.0

* Annotating new features with `since` javadoc
diff --git a/README.md b/README.md
@@ -197,7 +197,7 @@ To use Maven, add the following lines to your pom.xml file:
       <dependency>
         <groupId>com.google.api-client</groupId>
         <artifactId>google-api-client</artifactId>
-        <version>1.29.0</version>
+        <version>1.30.0</version>
       </dependency>
     </dependencies>
   </project>
@@ -210,7 +210,7 @@ repositories {
     mavenCentral()
 }
 dependencies {
-    compile 'com.google.api-client:google-api-client:1.29.0'
+    compile 'com.google.api-client:google-api-client:1.30.0'
 }
 ```
 [//]: # ({x-version-update-end})
diff --git a/google-api-client-android/pom.xml b/google-api-client-android/pom.xml
@@ -4,7 +4,7 @@
   <parent>
     <groupId>com.google.api-client</groupId>
     <artifactId>google-api-client-parent</artifactId>
-    <version>1.29.1-SNAPSHOT</version><!-- {x-version-update:google-api-client:current} -->
+    <version>1.30.0</version><!-- {x-version-update:google-api-client:current} -->
     <relativePath>../pom.xml</relativePath>
   </parent>
   <artifactId>google-api-client-android</artifactId>
diff --git a/google-api-client-appengine/pom.xml b/google-api-client-appengine/pom.xml
@@ -4,7 +4,7 @@
   <parent>
     <groupId>com.google.api-client</groupId>
     <artifactId>google-api-client-parent</artifactId>
-    <version>1.29.1-SNAPSHOT</version><!-- {x-version-update:google-api-client:current} -->
+    <version>1.30.0</version><!-- {x-version-update:google-api-client:current} -->
     <relativePath>../pom.xml</relativePath>
   </parent>
   <artifactId>google-api-client-appengine</artifactId>
diff --git a/google-api-client-assembly/pom.xml b/google-api-client-assembly/pom.xml
@@ -4,7 +4,7 @@
   <parent>
     <groupId>com.google.api-client</groupId>
     <artifactId>google-api-client-parent</artifactId>
-    <version>1.29.1-SNAPSHOT</version><!-- {x-version-update:google-api-client:current} -->
+    <version>1.30.0</version><!-- {x-version-update:google-api-client:current} -->
     <relativePath>../pom.xml</relativePath>
   </parent>
   <groupId>com.google.api-client</groupId>
diff --git a/google-api-client-bom/README.md b/google-api-client-bom/README.md
@@ -12,7 +12,7 @@ To use it in Maven, add the following to your `pom.xml`:
     <dependency>
       <groupId>com.google.api-client</groupId>
       <artifactId>google-api-client-bom</artifactId>
-      <version>1.29.0</version>
+      <version>1.30.0</version>
       <type>pom</type>
       <scope>import</scope>
     </dependency>
diff --git a/google-api-client-bom/pom.xml b/google-api-client-bom/pom.xml
@@ -3,7 +3,7 @@
   <modelVersion>4.0.0</modelVersion>
   <groupId>com.google.api-client</groupId>
   <artifactId>google-api-client-bom</artifactId>
-  <version>1.29.1-SNAPSHOT</version><!-- {x-version-update:google-api-client:current} -->
+  <version>1.30.0</version><!-- {x-version-update:google-api-client:current} -->
   <packaging>pom</packaging>
 
   <name>Google API Client Library for Java BOM</name>
@@ -63,52 +63,52 @@
       <dependency>
         <groupId>com.google.api-client</groupId>
         <artifactId>google-api-client</artifactId>
-        <version>1.29.1-SNAPSHOT</version><!-- {x-version-update:google-api-client:current} -->
+        <version>1.30.0</version><!-- {x-version-update:google-api-client:current} -->
       </dependency>
       <dependency>
         <groupId>com.google.api-client</groupId>
         <artifactId>google-api-client-android</artifactId>
-        <version>1.29.1-SNAPSHOT</version><!-- {x-version-update:google-api-client:current} -->
+        <version>1.30.0</version><!-- {x-version-update:google-api-client:current} -->
       </dependency>
       <dependency>
         <groupId>com.google.api-client</groupId>
         <artifactId>google-api-client-appengine</artifactId>
-        <version>1.29.1-SNAPSHOT</version><!-- {x-version-update:google-api-client:current} -->
+        <version>1.30.0</version><!-- {x-version-update:google-api-client:current} -->
       </dependency>
       <dependency>
         <groupId>com.google.api-client</groupId>
         <artifactId>google-api-client-assembly</artifactId>
-        <version>1.29.1-SNAPSHOT</version><!-- {x-version-update:google-api-client:current} -->
+        <version>1.30.0</version><!-- {x-version-update:google-api-client:current} -->
       </dependency>
       <dependency>
         <groupId>com.google.api-client</groupId>
         <artifactId>google-api-client-gson</artifactId>
-        <version>1.29.1-SNAPSHOT</version><!-- {x-version-update:google-api-client:current} -->
+        <version>1.30.0</version><!-- {x-version-update:google-api-client:current} -->
       </dependency>
       <dependency>
         <groupId>com.google.api-client</groupId>
         <artifactId>google-api-client-jackson2</artifactId>
-        <version>1.29.1-SNAPSHOT</version><!-- {x-version-update:google-api-client:current} -->
+        <version>1.30.0</version><!-- {x-version-update:google-api-client:current} -->
       </dependency>
       <dependency>
         <groupId>com.google.api-client</groupId>
         <artifactId>google-api-client-java6</artifactId>
-        <version>1.29.1-SNAPSHOT</version><!-- {x-version-update:google-api-client:current} -->
+        <version>1.30.0</version><!-- {x-version-update:google-api-client:current} -->
       </dependency>
       <dependency>
         <groupId>com.google.api-client</groupId>
         <artifactId>google-api-client-protobuf</artifactId>
-        <version>1.29.1-SNAPSHOT</version><!-- {x-version-update:google-api-client:current} -->
+        <version>1.30.0</version><!-- {x-version-update:google-api-client:current} -->
       </dependency>
       <dependency>
         <groupId>com.google.api-client</groupId>
         <artifactId>google-api-client-servlet</artifactId>
-        <version>1.29.1-SNAPSHOT</version><!-- {x-version-update:google-api-client:current} -->
+        <version>1.30.0</version><!-- {x-version-update:google-api-client:current} -->
       </dependency>
       <dependency>
         <groupId>com.google.api-client</groupId>
         <artifactId>google-api-client-xml</artifactId>
-        <version>1.29.1-SNAPSHOT</version><!-- {x-version-update:google-api-client:current} -->
+        <version>1.30.0</version><!-- {x-version-update:google-api-client:current} -->
       </dependency>
     </dependencies>
   </dependencyManagement>
diff --git a/google-api-client-gson/pom.xml b/google-api-client-gson/pom.xml
@@ -4,7 +4,7 @@
   <parent>
     <groupId>com.google.api-client</groupId>
     <artifactId>google-api-client-parent</artifactId>
-    <version>1.29.1-SNAPSHOT</version><!-- {x-version-update:google-api-client:current} -->
+    <version>1.30.0</version><!-- {x-version-update:google-api-client:current} -->
     <relativePath>../pom.xml</relativePath>
   </parent>
   <artifactId>google-api-client-gson</artifactId>
diff --git a/google-api-client-jackson2/pom.xml b/google-api-client-jackson2/pom.xml
@@ -4,7 +4,7 @@
   <parent>
     <groupId>com.google.api-client</groupId>
     <artifactId>google-api-client-parent</artifactId>
-    <version>1.29.1-SNAPSHOT</version><!-- {x-version-update:google-api-client:current} -->
+    <version>1.30.0</version><!-- {x-version-update:google-api-client:current} -->
     <relativePath>../pom.xml</relativePath>
   </parent>
   <artifactId>google-api-client-jackson2</artifactId>
diff --git a/google-api-client-java6/pom.xml b/google-api-client-java6/pom.xml
@@ -4,7 +4,7 @@
   <parent>
     <groupId>com.google.api-client</groupId>
     <artifactId>google-api-client-parent</artifactId>
-    <version>1.29.1-SNAPSHOT</version><!-- {x-version-update:google-api-client:current} -->
+    <version>1.30.0</version><!-- {x-version-update:google-api-client:current} -->
     <relativePath>../pom.xml</relativePath>
   </parent>
   <artifactId>google-api-client-java6</artifactId>
diff --git a/google-api-client-protobuf/pom.xml b/google-api-client-protobuf/pom.xml
@@ -4,7 +4,7 @@
   <parent>
     <groupId>com.google.api-client</groupId>
     <artifactId>google-api-client-parent</artifactId>
-    <version>1.29.1-SNAPSHOT</version><!-- {x-version-update:google-api-client:current} -->
+    <version>1.30.0</version><!-- {x-version-update:google-api-client:current} -->
     <relativePath>../pom.xml</relativePath>
   </parent>
   <artifactId>google-api-client-protobuf</artifactId>
diff --git a/google-api-client-servlet/pom.xml b/google-api-client-servlet/pom.xml
@@ -4,7 +4,7 @@
   <parent>
     <groupId>com.google.api-client</groupId>
     <artifactId>google-api-client-parent</artifactId>
-    <version>1.29.1-SNAPSHOT</version><!-- {x-version-update:google-api-client:current} -->
+    <version>1.30.0</version><!-- {x-version-update:google-api-client:current} -->
     <relativePath>../pom.xml</relativePath>
   </parent>
   <artifactId>google-api-client-servlet</artifactId>
diff --git a/google-api-client-xml/pom.xml b/google-api-client-xml/pom.xml
@@ -4,7 +4,7 @@
   <parent>
     <groupId>com.google.api-client</groupId>
     <artifactId>google-api-client-parent</artifactId>
-    <version>1.29.1-SNAPSHOT</version><!-- {x-version-update:google-api-client:current} -->
+    <version>1.30.0</version><!-- {x-version-update:google-api-client:current} -->
     <relativePath>../pom.xml</relativePath>
   </parent>
   <artifactId>google-api-client-xml</artifactId>
diff --git a/google-api-client/pom.xml b/google-api-client/pom.xml
@@ -4,7 +4,7 @@
   <parent>
     <groupId>com.google.api-client</groupId>
     <artifactId>google-api-client-parent</artifactId>
-    <version>1.29.1-SNAPSHOT</version><!-- {x-version-update:google-api-client:current} -->
+    <version>1.30.0</version><!-- {x-version-update:google-api-client:current} -->
     <relativePath>../pom.xml</relativePath>
   </parent>
   <artifactId>google-api-client</artifactId>
diff --git a/google-api-client/src/main/java/com/google/api/client/googleapis/services/AbstractGoogleClientRequest.java b/google-api-client/src/main/java/com/google/api/client/googleapis/services/AbstractGoogleClientRequest.java
@@ -225,7 +225,11 @@ public final boolean getDisableGZipContent() {
     return disableGZipContent;
   }
 
-  /** Returns whether response should return raw input stream. */
+  /**
+   * Returns whether response should return raw input stream.
+   *
+   * @since 1.30
+   * */
   public final boolean getReturnRawInputSteam() {
     return returnRawInputStream;
   }
@@ -260,6 +264,8 @@ public AbstractGoogleClientRequest<T> setDisableGZipContent(boolean disableGZipC
    * chunks (see <a href="https://github.com/googleapis/google-api-java-client/issues/1009">#1009
    * </a>). Setting this to true will make the response return the raw input stream.
    * </p>
+   *
+   * @since 1.30
    */
   public AbstractGoogleClientRequest<T> setReturnRawInputStream(boolean returnRawInputStream) {
     this.returnRawInputStream = returnRawInputStream;
diff --git a/google-api-client/src/main/java/com/google/api/client/googleapis/services/CommonGoogleClientRequestInitializer.java b/google-api-client/src/main/java/com/google/api/client/googleapis/services/CommonGoogleClientRequestInitializer.java
@@ -150,6 +150,8 @@ protected CommonGoogleClientRequestInitializer(Builder builder) {
 
   /**
    * Returns new builder.
+   *
+   * @since 1.30
    */
   public static Builder newBuilder() {
     return new Builder();
@@ -198,13 +200,15 @@ public final String getRequestReason() {
     return requestReason;
   }
 
-  /** Returns the user project of {@code null} */
+  /** Returns the user project or {@code null}. */
   public final String getUserProject() {
     return userProject;
   }
 
   /**
    * Builder for {@code CommonGoogleClientRequestInitializer}.
+   *
+   * @since 1.30
    */
   public static class Builder {
     private String key;
diff --git a/google-api-client/src/main/java/com/google/api/client/googleapis/services/json/CommonGoogleJsonClientRequestInitializer.java b/google-api-client/src/main/java/com/google/api/client/googleapis/services/json/CommonGoogleJsonClientRequestInitializer.java
@@ -137,6 +137,8 @@ protected void initializeJsonRequest(AbstractGoogleJsonClientRequest<?> request)
 
   /**
    * Builder for {@code CommonGoogleJsonClientRequestInitializer}.
+   *
+   * @since 1.30
    */
   public static class Builder extends CommonGoogleClientRequestInitializer.Builder {
     @Override
diff --git a/pom.xml b/pom.xml
@@ -9,7 +9,7 @@
   </parent>
   <groupId>com.google.api-client</groupId>
   <artifactId>google-api-client-parent</artifactId>
-  <version>1.29.1-SNAPSHOT</version><!-- {x-version-update:google-api-client:current} -->
+  <version>1.30.0</version><!-- {x-version-update:google-api-client:current} -->
   <packaging>pom</packaging>
   <name>Parent for the Google API Client Library for Java</name>
 
diff --git a/versions.txt b/versions.txt
@@ -1,4 +1,4 @@
 # Format:
 # module:released-version:current-version
 
-google-api-client:1.29.0:1.29.1-SNAPSHOT
+google-api-client:1.30.0:1.30.0
