Add support for bucket labels

src/Storage/Bucket.php

@@ -532,6 +532,7 @@ public function delete(array $options = [])
      * ```
      *
      * @see https://cloud.google.com/storage/docs/json_api/v1/buckets/patch Buckets patch API documentation.
+     * @see https://cloud.google.com/storage/docs/key-terms#bucket-labels Bucket Labels
      *
      * @param array $options [optional] {
      *     Configuration options.
@@ -571,6 +572,9 @@ public function delete(array $options = [])
      *           `"STANDARD"` and `"DURABLE_REDUCED_AVAILABILITY"`.
      *     @type array $versioning The bucket's versioning configuration.
      *     @type array $website The bucket's website configuration.
+     *     @type array $labels The Bucket labels. Labels are represented as an
+     *           array of keys and values. To remove an existing label, set its
+     *           value to `null`.
      * }
      * @return array
      */

src/Storage/Connection/ServiceDefinition/storage-v1.json

@@ -163,6 +163,14 @@
                     "description": "The kind of item this is. For buckets, this is always storage#bucket.",
                     "default": "storage#bucket"
                 },
+                "labels": {
+                    "type": "object",
+                    "description": "User-provided labels, in key/value pairs.",
+                    "additionalProperties": {
+                        "type": "string",
+                        "description": "An individual label entry."
+                    }
+                },
                 "lifecycle": {
                     "type": "object",
                     "description": "The bucket's lifecycle configuration. See lifecycle management for more information.",

tests/system/Storage/ManageBucketsTest.php

@@ -19,6 +19,7 @@
 
 /**
  * @group storage
+ * @group storage-bucket
  */
 class ManageBucketsTest extends StorageTestCase
 {
@@ -122,4 +123,39 @@ public function testIam()
         $test = $iam->testPermissions($permissions);
         $this->assertEquals($permissions, $test);
     }
+
+    public function testLabels()
+    {
+        $bucket = self::$bucket;
+
+        $bucket->update([
+            'labels' => [
+                'foo' => 'bar'
+            ]
+        ]);
+
+        $bucket->reload();
+
+        $this->assertEquals($bucket->info()['labels']['foo'], 'bar');
+
+        $bucket->update([
+            'labels' => [
+                'foo' => 'bat'
+            ]
+        ]);
+
+        $bucket->reload();
+
+        $this->assertEquals($bucket->info()['labels']['foo'], 'bat');
+
+        $bucket->update([
+            'labels' => [
+                'foo' => null
+            ]
+        ]);
+
+        $bucket->reload();
+
+        $this->assertFalse(isset($bucket->info()['labels']['foo']));
+    }
 }