---

JesseLovelace · web-flow · commit 74e93253ac87 · 2019-05-13T11:02:00.000-07:00
yaml --- r: 32383 b: refs/heads/autosynth-errorreporting c: 1b29001 h: refs/heads/master i: 32381: 8fa6393 32379: 2963151 32375: 6b5c9cb 32367: 960807f 32351: ca8dee9 32319: 9360297 32255: 3b43337
diff --git a/[refs] b/[refs]
@@ -129,7 +129,7 @@ refs/heads/autosynth-bigtable-admin: 6379a2bc712f2736c83de0e009b4d26da4fa82ca
 refs/heads/autosynth-containeranalysis: 18d210f81f17cf74864d0db2c29e834302f74f2a
 refs/heads/autosynth-datastore: f1efc3dc465174f41041acd56cf29badcec3e5bd
 refs/heads/autosynth-dialogflow: 73974cc32e5212aec0126472e0bc1442886fedaf
-refs/heads/autosynth-errorreporting: 7d47fce81df96e1a0e0270cfe264fcecbfb0bb22
+refs/heads/autosynth-errorreporting: 1b29001e39672994368e51ce6fae44a5528613fa
 refs/heads/autosynth-firestore: 983c75e4fb1076502c8cac73ef0538bdb10884f3
 refs/heads/autosynth-iot: 4025d1804241e74d54950a324dc4f667aeaad4b3
 refs/heads/autosynth-kms: 6b65b0f34c12d141031c7288cdc01e550212d0f6
diff --git a/branches/autosynth-errorreporting/google-cloud-clients/google-cloud-storage/src/main/java/com/google/cloud/storage/Blob.java b/branches/autosynth-errorreporting/google-cloud-clients/google-cloud-storage/src/main/java/com/google/cloud/storage/Blob.java
@@ -512,17 +512,33 @@ public Blob reload(BlobSourceOption... options) {
    * current blob metadata are at their latest version use the {@code metagenerationMatch} option:
    * {@code newBlob.update(BlobTargetOption.metagenerationMatch())}.
    *
-   * <p>Original metadata are merged with metadata in the provided in this {@code blob}. To replace
-   * metadata instead you first have to unset them. Unsetting metadata can be done by setting this
-   * {@code blob}'s metadata to {@code null}.
+   * <p>Original metadata are merged with metadata in the provided {@code blobInfo}. If the original
+   * metadata already contains a key specified in the provided {@code blobInfo's} metadata map, it
+   * will be replaced by the new value. Removing metadata can be done by setting that metadata's
+   * value to {@code null}.
    *
-   * <p>Example of replacing blob's metadata.
+   * <p>Example of adding new metadata values or updating existing ones.
    *
    * <pre>{@code
+   * String bucketName = "my_unique_bucket";
+   * String blobName = "my_blob_name";
+   * Map<String, String> newMetadata = new HashMap<>();
+   * newMetadata.put("keyToAddOrUpdate", "value");
+   * Blob blob = storage.update(BlobInfo.newBuilder(bucketName, blobName)
+   *     .setMetadata(newMetadata)
+   *     .build());
+   * }</pre>
+   *
+   * <p>Example of removing metadata values.
+   *
+   * <pre>{@code
+   * String bucketName = "my_unique_bucket";
+   * String blobName = "my_blob_name";
    * Map<String, String> newMetadata = new HashMap<>();
-   * newMetadata.put("key", "value");
-   * blob.toBuilder().setMetadata(null).build().update();
-   * Blob updatedBlob = blob.toBuilder().setMetadata(newMetadata).build().update();
+   * newMetadata.put("keyToRemove", null);
+   * Blob blob = storage.update(BlobInfo.newBuilder(bucketName, blobName)
+   *     .setMetadata(newMetadata)
+   *     .build());
    * }</pre>
    *
    * @param options update options
diff --git a/branches/autosynth-errorreporting/google-cloud-clients/google-cloud-storage/src/main/java/com/google/cloud/storage/Storage.java b/branches/autosynth-errorreporting/google-cloud-clients/google-cloud-storage/src/main/java/com/google/cloud/storage/Storage.java
@@ -1718,17 +1718,29 @@ Blob create(
 
   /**
    * Updates blob information. Original metadata are merged with metadata in the provided {@code
-   * blobInfo}. To replace metadata instead you first have to unset them. Unsetting metadata can be
-   * done by setting the provided {@code blobInfo}'s metadata to {@code null}.
+   * blobInfo}. If the original metadata already contains a key specified in the provided {@code
+   * blobInfo's} metadata map, it will be replaced by the new value. Removing metadata can be done
+   * by setting that metadata's value to {@code null}.
+   *
+   * <p>Example of adding new metadata values or updating existing ones.
+   *
+   * <pre>{@code
+   * String bucketName = "my_unique_bucket";
+   * String blobName = "my_blob_name";
+   * Map<String, String> newMetadata = new HashMap<>();
+   * newMetadata.put("keyToAddOrUpdate", "value");
+   * Blob blob = storage.update(BlobInfo.newBuilder(bucketName, blobName)
+   *     .setMetadata(newMetadata)
+   *     .build());
+   * }</pre>
    *
-   * <p>Example of replacing blob's metadata.
+   * <p>Example of removing metadata values.
    *
    * <pre>{@code
    * String bucketName = "my_unique_bucket";
    * String blobName = "my_blob_name";
    * Map<String, String> newMetadata = new HashMap<>();
-   * newMetadata.put("key", "value");
-   * storage.update(BlobInfo.newBuilder(bucketName, blobName).setMetadata(null).build());
+   * newMetadata.put("keyToRemove", null);
    * Blob blob = storage.update(BlobInfo.newBuilder(bucketName, blobName)
    *     .setMetadata(newMetadata)
    *     .build());
