feat(spanner): [Spanner] add proto descriptors for proto and enum types in create/update/get database ddl requests

Spanner/src/Admin/Database/V1/Gapic/DatabaseAdminGapicClient.php

@@ -829,6 +829,22 @@ public function createBackup(
      *     @type int $databaseDialect
      *           Optional. The dialect of the Cloud Spanner Database.
      *           For allowed values, use constants defined on {@see \Google\Cloud\Spanner\Admin\Database\V1\DatabaseDialect}
+     *     @type string $protoDescriptors
+     *           Optional. Proto descriptors used by CREATE/ALTER PROTO BUNDLE statements in
+     *           'extra_statements' above.
+     *           Contains a protobuf-serialized
+     *           [google.protobuf.FileDescriptorSet](https://github.com/protocolbuffers/protobuf/blob/main/src/google/protobuf/descriptor.proto).
+     *           To generate it, [install](https://grpc.io/docs/protoc-installation/) and
+     *           run `protoc` with --include_imports and --descriptor_set_out. For example,
+     *           to generate for moon/shot/app.proto, run
+     *           ```
+     *           $protoc  --proto_path=/app_path --proto_path=/lib_path \
+     *           --include_imports \
+     *           --descriptor_set_out=descriptors.data \
+     *           moon/shot/app.proto
+     *           ```
+     *           For more details, see protobuffer [self
+     *           description](https://developers.google.com/protocol-buffers/docs/techniques#self-description).
      *     @type RetrySettings|array $retrySettings
      *           Retry settings to use for this call. Can be a {@see RetrySettings} object, or an
      *           associative array of retry settings parameters. See the documentation on
@@ -861,6 +877,10 @@ public function createDatabase(
             $request->setDatabaseDialect($optionalArgs['databaseDialect']);
         }
 
+        if (isset($optionalArgs['protoDescriptors'])) {
+            $request->setProtoDescriptors($optionalArgs['protoDescriptors']);
+        }
+
         $requestParams = new RequestParamsHeaderDescriptor(
             $requestParamHeaders
         );
@@ -2256,6 +2276,21 @@ public function updateDatabase(
      *           underscore. If the named operation already exists,
      *           [UpdateDatabaseDdl][google.spanner.admin.database.v1.DatabaseAdmin.UpdateDatabaseDdl] returns
      *           `ALREADY_EXISTS`.
+     *     @type string $protoDescriptors
+     *           Optional. Proto descriptors used by CREATE/ALTER PROTO BUNDLE statements.
+     *           Contains a protobuf-serialized
+     *           [google.protobuf.FileDescriptorSet](https://github.com/protocolbuffers/protobuf/blob/main/src/google/protobuf/descriptor.proto).
+     *           To generate it, [install](https://grpc.io/docs/protoc-installation/) and
+     *           run `protoc` with --include_imports and --descriptor_set_out. For example,
+     *           to generate for moon/shot/app.proto, run
+     *           ```
+     *           $protoc  --proto_path=/app_path --proto_path=/lib_path \
+     *           --include_imports \
+     *           --descriptor_set_out=descriptors.data \
+     *           moon/shot/app.proto
+     *           ```
+     *           For more details, see protobuffer [self
+     *           description](https://developers.google.com/protocol-buffers/docs/techniques#self-description).
      *     @type RetrySettings|array $retrySettings
      *           Retry settings to use for this call. Can be a {@see RetrySettings} object, or an
      *           associative array of retry settings parameters. See the documentation on
@@ -2280,6 +2315,10 @@ public function updateDatabaseDdl(
             $request->setOperationId($optionalArgs['operationId']);
         }
 
+        if (isset($optionalArgs['protoDescriptors'])) {
+            $request->setProtoDescriptors($optionalArgs['protoDescriptors']);
+        }
+
         $requestParams = new RequestParamsHeaderDescriptor(
             $requestParamHeaders
         );

Spanner/tests/Unit/Admin/Database/V1/Client/DatabaseAdminClientTest.php

@@ -788,7 +788,9 @@ public function getDatabaseDdlTest()
         ]);
         $this->assertTrue($transport->isExhausted());
         // Mock response
+        $protoDescriptors = '13';
         $expectedResponse = new GetDatabaseDdlResponse();
+        $expectedResponse->setProtoDescriptors($protoDescriptors);
         $transport->addResponse($expectedResponse);
         // Mock request
         $formattedDatabase = $gapicClient->databaseName('[PROJECT]', '[INSTANCE]', '[DATABASE]');

Spanner/tests/Unit/Admin/Database/V1/DatabaseAdminClientTest.php

@@ -728,7 +728,9 @@ public function getDatabaseDdlTest()
         ]);
         $this->assertTrue($transport->isExhausted());
         // Mock response
+        $protoDescriptors = '13';
         $expectedResponse = new GetDatabaseDdlResponse();
+        $expectedResponse->setProtoDescriptors($protoDescriptors);
         $transport->addResponse($expectedResponse);
         // Mock request
         $formattedDatabase = $gapicClient->databaseName('[PROJECT]', '[INSTANCE]', '[DATABASE]');