Improve GCS signUrlOption javadoc (googleapis#1928)

danielcompton · andreamlin · commit 90db468b0d70 · 2018-01-09T13:50:32.000-08:00
* Improve GCS signUrlOption javadoc
* Update comment for httpMethod URL signing option
diff --git a/google-cloud-storage/src/main/java/com/google/cloud/storage/Storage.java b/google-cloud-storage/src/main/java/com/google/cloud/storage/Storage.java
@@ -893,7 +893,8 @@ Object getValue() {
     }
 
     /**
-     * The HTTP method to be used with the signed URL.
+     * The HTTP method to be used with the signed URL. 
+     * If this method is not called, defaults to GET.
      */
     public static SignUrlOption httpMethod(HttpMethod httpMethod) {
       return new SignUrlOption(Option.HTTP_METHOD, httpMethod.name());
@@ -902,6 +903,7 @@ public static SignUrlOption httpMethod(HttpMethod httpMethod) {
     /**
      * Use it if signature should include the blob's content-type.
      * When used, users of the signed URL should include the blob's content-type with their request.
+     * If using this URL from a browser, you must include a content type that matches what the browser will send.
      */
     public static SignUrlOption withContentType() {
       return new SignUrlOption(Option.CONTENT_TYPE, true);
