google-apis-firebasedataconnect_v1 0.7.0 → 0.9.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: d943a1ac39452816e4ffd5f63b8bfa848dba5e9bf9f0e215426c828141413bc3
-  data.tar.gz: 137924e80bbfeb75d01b1cf59bcdb6acb49ebb88798163b4388e1e9cb5cea513
+  metadata.gz: f2399bf8183f1b81094983cbe6c06e587720162aa448452d3e426c45d2c4932b
+  data.tar.gz: abcdf2bc21749922166f9d2f87ec121ba90fd3e1a98de93f793671ca1cb51d08
 SHA512:
-  metadata.gz: 4a03d17bbc76f42059b4ce39e02a2332de55cca1403ed3fcb3813c4fa1e9ab9ed58771db290649a54256110a936c0f7a11bdcad38bed203d02722484a12b7ff3
-  data.tar.gz: 96530869b06f1b902b4f0929d620d4271dd82a0ac488b1e913feb6617d9ea0cb531715da2bcb37e8d05e5c3de6a067a1a231365fc5638a8b55e11c52dfdbb3fd
+  metadata.gz: 47eb40b03935e582345357e5d8a0fb627d71c3097f6727eb8f72eedcbd0c747f0ba27b54f28f615edf564ba607a68516eac8eea3c8cf3f03ba9030a3ab400f59
+  data.tar.gz: 3421b52b68ece7f1fb8368e89d98edd82f29a019fb7325d36342d163442f5e88634f7bbc84fe471fa90274a14813095c1a7bb9b5e32820f8d1b79d078d3ba6ba

data/CHANGELOG.md

@@ -1,5 +1,13 @@
 # Release history for google-apis-firebasedataconnect_v1
 
+### v0.9.0 (2025-10-26)
+
+* Regenerated from discovery document revision 20251021
+
+### v0.8.0 (2025-09-14)
+
+* Regenerated from discovery document revision 20250907
+
 ### v0.7.0 (2025-08-31)
 
 * Regenerated from discovery document revision 20250824

data/lib/google/apis/firebasedataconnect_v1/classes.rb

@@ -305,10 +305,12 @@ module Google
       # draft/#sec-Errors Firebase Data Connect API surfaces `GraphqlError` in various
       # APIs: - Upon compile error, `UpdateSchema` and `UpdateConnector` return Code.
       # Invalid_Argument with a list of `GraphqlError` in error details. - Upon query
-      # compile error, `ExecuteGraphql` and `ExecuteGraphqlRead` return Code.OK with a
-      # list of `GraphqlError` in response body. - Upon query execution error, `
-      # ExecuteGraphql`, `ExecuteGraphqlRead`, `ExecuteMutation` and `ExecuteQuery`
-      # all return Code.OK with a list of `GraphqlError` in response body.
+      # compile error, `ExecuteGraphql`, `ExecuteGraphqlRead` and `IntrospectGraphql`
+      # return Code.OK with a list of `GraphqlError` in response body. - Upon query
+      # execution error, `ExecuteGraphql`, `ExecuteGraphqlRead`, `ExecuteMutation`, `
+      # ExecuteQuery`, `IntrospectGraphql`, `ImpersonateQuery` and `
+      # ImpersonateMutation` all return Code.OK with a list of `GraphqlError` in
+      # response body.
       class GraphqlError
         include Google::Apis::Core::Hashable
       
@@ -319,10 +321,11 @@ module Google
       
         # The source locations where the error occurred. Locations should help
         # developers and toolings identify the source of error quickly. Included in
-        # admin endpoints (`ExecuteGraphql`, `ExecuteGraphqlRead`, `UpdateSchema` and `
-        # UpdateConnector`) to reference the provided GraphQL GQL document. Omitted in `
-        # ExecuteMutation` and `ExecuteQuery` since the caller shouldn't have access
-        # access the underlying GQL source.
+        # admin endpoints (`ExecuteGraphql`, `ExecuteGraphqlRead`, `IntrospectGraphql`, `
+        # ImpersonateQuery`, `ImpersonateMutation`, `UpdateSchema` and `UpdateConnector`)
+        # to reference the provided GraphQL GQL document. Omitted in `ExecuteMutation`
+        # and `ExecuteQuery` since the caller shouldn't have access access the
+        # underlying GQL source.
         # Corresponds to the JSON property `locations`
         # @return [Array<Google::Apis::FirebasedataconnectV1::SourceLocation>]
         attr_accessor :locations
@@ -380,11 +383,16 @@ module Google
         # @return [String]
         attr_accessor :file
       
-        # Distinguish which schema or connector the error originates from. It should be
-        # set on errors from control plane APIs (e.g. `UpdateSchema`, `UpdateConnector`).
-        # Corresponds to the JSON property `resource`
+        # Warning level describes the severity and required action to suppress this
+        # warning when Firebase CLI run into it.
+        # Corresponds to the JSON property `warningLevel`
         # @return [String]
-        attr_accessor :resource
+        attr_accessor :warning_level
+      
+        # Workarounds provide suggestions to address the compile errors or warnings.
+        # Corresponds to the JSON property `workarounds`
+        # @return [Array<Google::Apis::FirebasedataconnectV1::Workaround>]
+        attr_accessor :workarounds
       
         def initialize(**args)
            update!(**args)
@@ -395,7 +403,8 @@ module Google
           @code = args[:code] if args.key?(:code)
           @debug_details = args[:debug_details] if args.key?(:debug_details)
           @file = args[:file] if args.key?(:file)
-          @resource = args[:resource] if args.key?(:resource)
+          @warning_level = args[:warning_level] if args.key?(:warning_level)
+          @workarounds = args[:workarounds] if args.key?(:workarounds)
         end
       end
       
@@ -494,6 +503,39 @@ module Google
         end
       end
       
+      # The Impersonate request to Firebase Data Connect.
+      class ImpersonateRequest
+        include Google::Apis::Core::Hashable
+      
+        # GraphqlRequestExtensions contains additional information of `GraphqlRequest`.
+        # Corresponds to the JSON property `extensions`
+        # @return [Google::Apis::FirebasedataconnectV1::GraphqlRequestExtensions]
+        attr_accessor :extensions
+      
+        # Required. The name of the GraphQL operation name. Required because all
+        # Connector operations must be named. See https://graphql.org/learn/queries/#
+        # operation-name.
+        # Corresponds to the JSON property `operationName`
+        # @return [String]
+        attr_accessor :operation_name
+      
+        # Optional. Values for GraphQL variables provided in this request.
+        # Corresponds to the JSON property `variables`
+        # @return [Hash<String,Object>]
+        attr_accessor :variables
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @extensions = args[:extensions] if args.key?(:extensions)
+          @operation_name = args[:operation_name] if args.key?(:operation_name)
+          @variables = args[:variables] if args.key?(:variables)
+        end
+      end
+      
       # Impersonation configures the Firebase Auth context to impersonate.
       class Impersonation
         include Google::Apis::Core::Hashable
@@ -605,6 +647,13 @@ module Google
         # @return [Array<Google::Apis::FirebasedataconnectV1::Operation>]
         attr_accessor :operations
       
+        # Unordered list. Unreachable resources. Populated when the request sets `
+        # ListOperationsRequest.return_partial_success` and reads across collections e.g.
+        # when attempting to list all resources across all supported locations.
+        # Corresponds to the JSON property `unreachable`
+        # @return [Array<String>]
+        attr_accessor :unreachable
+      
         def initialize(**args)
            update!(**args)
         end
@@ -613,6 +662,7 @@ module Google
         def update!(**args)
           @next_page_token = args[:next_page_token] if args.key?(:next_page_token)
           @operations = args[:operations] if args.key?(:operations)
+          @unreachable = args[:unreachable] if args.key?(:unreachable)
         end
       end
       
@@ -1162,6 +1212,37 @@ module Google
           @message = args[:message] if args.key?(:message)
         end
       end
+      
+      # Workaround provides suggestions to address errors and warnings.
+      class Workaround
+        include Google::Apis::Core::Hashable
+      
+        # Description of this workaround.
+        # Corresponds to the JSON property `description`
+        # @return [String]
+        attr_accessor :description
+      
+        # Why would this workaround address the error and warning.
+        # Corresponds to the JSON property `reason`
+        # @return [String]
+        attr_accessor :reason
+      
+        # A suggested code snippet to fix the error and warning.
+        # Corresponds to the JSON property `replace`
+        # @return [String]
+        attr_accessor :replace
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @description = args[:description] if args.key?(:description)
+          @reason = args[:reason] if args.key?(:reason)
+          @replace = args[:replace] if args.key?(:replace)
+        end
+      end
     end
   end
 end

data/lib/google/apis/firebasedataconnect_v1/gem_version.rb

@@ -16,13 +16,13 @@ module Google
   module Apis
     module FirebasedataconnectV1
       # Version of the google-apis-firebasedataconnect_v1 gem
-      GEM_VERSION = "0.7.0"
+      GEM_VERSION = "0.9.0"
 
       # Version of the code generator used to generate this client
       GENERATOR_VERSION = "0.18.0"
 
       # Revision of the discovery document this client was generated from
-      REVISION = "20250824"
+      REVISION = "20251021"
     end
   end
 end

data/lib/google/apis/firebasedataconnect_v1/representations.rb

@@ -112,6 +112,12 @@ module Google
         include Google::Apis::Core::JsonObjectSupport
       end
       
+      class ImpersonateRequest
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      
+        include Google::Apis::Core::JsonObjectSupport
+      end
+      
       class Impersonation
         class Representation < Google::Apis::Core::JsonRepresentation; end
       
@@ -202,6 +208,12 @@ module Google
         include Google::Apis::Core::JsonObjectSupport
       end
       
+      class Workaround
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      
+        include Google::Apis::Core::JsonObjectSupport
+      end
+      
       class CancelOperationRequest
         # @private
         class Representation < Google::Apis::Core::JsonRepresentation
@@ -306,7 +318,9 @@ module Google
           property :code, as: 'code'
           property :debug_details, as: 'debugDetails'
           property :file, as: 'file'
-          property :resource, as: 'resource'
+          property :warning_level, as: 'warningLevel'
+          collection :workarounds, as: 'workarounds', class: Google::Apis::FirebasedataconnectV1::Workaround, decorator: Google::Apis::FirebasedataconnectV1::Workaround::Representation
+      
         end
       end
       
@@ -338,6 +352,16 @@ module Google
         end
       end
       
+      class ImpersonateRequest
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+          property :extensions, as: 'extensions', class: Google::Apis::FirebasedataconnectV1::GraphqlRequestExtensions, decorator: Google::Apis::FirebasedataconnectV1::GraphqlRequestExtensions::Representation
+      
+          property :operation_name, as: 'operationName'
+          hash :variables, as: 'variables'
+        end
+      end
+      
       class Impersonation
         # @private
         class Representation < Google::Apis::Core::JsonRepresentation
@@ -372,6 +396,7 @@ module Google
           property :next_page_token, as: 'nextPageToken'
           collection :operations, as: 'operations', class: Google::Apis::FirebasedataconnectV1::Operation, decorator: Google::Apis::FirebasedataconnectV1::Operation::Representation
       
+          collection :unreachable, as: 'unreachable'
         end
       end
       
@@ -502,6 +527,15 @@ module Google
           property :message, as: 'message'
         end
       end
+      
+      class Workaround
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+          property :description, as: 'description'
+          property :reason, as: 'reason'
+          property :replace, as: 'replace'
+        end
+      end
     end
   end
 end

data/lib/google/apis/firebasedataconnect_v1/service.rb

@@ -245,6 +245,13 @@ module Google
         #   The standard list page size.
         # @param [String] page_token
         #   The standard list page token.
+        # @param [Boolean] return_partial_success
+        #   When set to `true`, operations that are reachable are returned as normal, and
+        #   those that are unreachable are returned in the [ListOperationsResponse.
+        #   unreachable] field. This can only be `true` when reading across collections e.
+        #   g. when `parent` is set to `"projects/example/locations/-"`. This field is not
+        #   by default supported and will result in an `UNIMPLEMENTED` error if set unless
+        #   explicitly documented otherwise in service or product specific documentation.
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
@@ -262,7 +269,7 @@ module Google
         # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
         # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
         # @raise [Google::Apis::AuthorizationError] Authorization is required
-        def list_project_location_operations(name, filter: nil, page_size: nil, page_token: nil, fields: nil, quota_user: nil, options: nil, &block)
+        def list_project_location_operations(name, filter: nil, page_size: nil, page_token: nil, return_partial_success: nil, fields: nil, quota_user: nil, options: nil, &block)
           command = make_simple_command(:get, 'v1/{+name}/operations', options)
           command.response_representation = Google::Apis::FirebasedataconnectV1::ListOperationsResponse::Representation
           command.response_class = Google::Apis::FirebasedataconnectV1::ListOperationsResponse
@@ -270,6 +277,7 @@ module Google
           command.query['filter'] = filter unless filter.nil?
           command.query['pageSize'] = page_size unless page_size.nil?
           command.query['pageToken'] = page_token unless page_token.nil?
+          command.query['returnPartialSuccess'] = return_partial_success unless return_partial_success.nil?
           command.query['fields'] = fields unless fields.nil?
           command.query['quotaUser'] = quota_user unless quota_user.nil?
           execute_or_queue_command(command, &block)
@@ -493,6 +501,45 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
+        # Execute introspection query against the Firebase Data Connect's generated
+        # GraphQL schema. GraphQL introspection query provides metadata such as what
+        # tables the schema have, what queries and mutations can be performed on the
+        # schema, and so on. Read more at https://graphql.org/learn/introspection.
+        # IntrospectGraphql can read schema metadata but cannot read rows from Cloud SQL
+        # instance, which can be done via ExecuteGraphqlRead.
+        # @param [String] name
+        #   Required. The relative resource name of Firebase Data Connect service, in the
+        #   format: ``` projects/`project`/locations/`location`/services/`service` ```
+        # @param [Google::Apis::FirebasedataconnectV1::GraphqlRequest] graphql_request_object
+        # @param [String] fields
+        #   Selector specifying which fields to include in a partial response.
+        # @param [String] quota_user
+        #   Available to use for quota purposes for server-side applications. Can be any
+        #   arbitrary string assigned to a user, but should not exceed 40 characters.
+        # @param [Google::Apis::RequestOptions] options
+        #   Request-specific options
+        #
+        # @yield [result, err] Result & error if block supplied
+        # @yieldparam result [Google::Apis::FirebasedataconnectV1::GraphqlResponse] parsed result object
+        # @yieldparam err [StandardError] error object if request failed
+        #
+        # @return [Google::Apis::FirebasedataconnectV1::GraphqlResponse]
+        #
+        # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
+        # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
+        # @raise [Google::Apis::AuthorizationError] Authorization is required
+        def introspect_project_location_service_graphql(name, graphql_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
+          command = make_simple_command(:post, 'v1/{+name}:introspectGraphql', options)
+          command.request_representation = Google::Apis::FirebasedataconnectV1::GraphqlRequest::Representation
+          command.request_object = graphql_request_object
+          command.response_representation = Google::Apis::FirebasedataconnectV1::GraphqlResponse::Representation
+          command.response_class = Google::Apis::FirebasedataconnectV1::GraphqlResponse
+          command.params['name'] = name unless name.nil?
+          command.query['fields'] = fields unless fields.nil?
+          command.query['quotaUser'] = quota_user unless quota_user.nil?
+          execute_or_queue_command(command, &block)
+        end
+        
         # Lists Services in a given project and location.
         # @param [String] parent
         #   Required. Value of parent.
@@ -819,6 +866,82 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
+        # Impersonate a mutation defined on a Firebase Data Connect connector. It grants
+        # the admin SDK access to mutations defined in the given connector. The caller
+        # can choose to impersonate a particular Firebase Auth user, or skip @auth
+        # completely.
+        # @param [String] name
+        #   Required. The resource name of the connector to find the predefined query/
+        #   mutation, in the format: ``` projects/`project`/locations/`location`/services/`
+        #   service`/connectors/`connector` ```
+        # @param [Google::Apis::FirebasedataconnectV1::ImpersonateRequest] impersonate_request_object
+        # @param [String] fields
+        #   Selector specifying which fields to include in a partial response.
+        # @param [String] quota_user
+        #   Available to use for quota purposes for server-side applications. Can be any
+        #   arbitrary string assigned to a user, but should not exceed 40 characters.
+        # @param [Google::Apis::RequestOptions] options
+        #   Request-specific options
+        #
+        # @yield [result, err] Result & error if block supplied
+        # @yieldparam result [Google::Apis::FirebasedataconnectV1::GraphqlResponse] parsed result object
+        # @yieldparam err [StandardError] error object if request failed
+        #
+        # @return [Google::Apis::FirebasedataconnectV1::GraphqlResponse]
+        #
+        # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
+        # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
+        # @raise [Google::Apis::AuthorizationError] Authorization is required
+        def impersonate_project_location_service_connector_mutation(name, impersonate_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
+          command = make_simple_command(:post, 'v1/{+name}:impersonateMutation', options)
+          command.request_representation = Google::Apis::FirebasedataconnectV1::ImpersonateRequest::Representation
+          command.request_object = impersonate_request_object
+          command.response_representation = Google::Apis::FirebasedataconnectV1::GraphqlResponse::Representation
+          command.response_class = Google::Apis::FirebasedataconnectV1::GraphqlResponse
+          command.params['name'] = name unless name.nil?
+          command.query['fields'] = fields unless fields.nil?
+          command.query['quotaUser'] = quota_user unless quota_user.nil?
+          execute_or_queue_command(command, &block)
+        end
+        
+        # Impersonate a query defined on a Firebase Data Connect connector. It grants
+        # the admin SDK access to queries defined in the given connector. The caller can
+        # choose to impersonate a particular Firebase Auth user, or skip @auth
+        # completely.
+        # @param [String] name
+        #   Required. The resource name of the connector to find the predefined query/
+        #   mutation, in the format: ``` projects/`project`/locations/`location`/services/`
+        #   service`/connectors/`connector` ```
+        # @param [Google::Apis::FirebasedataconnectV1::ImpersonateRequest] impersonate_request_object
+        # @param [String] fields
+        #   Selector specifying which fields to include in a partial response.
+        # @param [String] quota_user
+        #   Available to use for quota purposes for server-side applications. Can be any
+        #   arbitrary string assigned to a user, but should not exceed 40 characters.
+        # @param [Google::Apis::RequestOptions] options
+        #   Request-specific options
+        #
+        # @yield [result, err] Result & error if block supplied
+        # @yieldparam result [Google::Apis::FirebasedataconnectV1::GraphqlResponse] parsed result object
+        # @yieldparam err [StandardError] error object if request failed
+        #
+        # @return [Google::Apis::FirebasedataconnectV1::GraphqlResponse]
+        #
+        # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
+        # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
+        # @raise [Google::Apis::AuthorizationError] Authorization is required
+        def impersonate_project_location_service_connector_query(name, impersonate_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
+          command = make_simple_command(:post, 'v1/{+name}:impersonateQuery', options)
+          command.request_representation = Google::Apis::FirebasedataconnectV1::ImpersonateRequest::Representation
+          command.request_object = impersonate_request_object
+          command.response_representation = Google::Apis::FirebasedataconnectV1::GraphqlResponse::Representation
+          command.response_class = Google::Apis::FirebasedataconnectV1::GraphqlResponse
+          command.params['name'] = name unless name.nil?
+          command.query['fields'] = fields unless fields.nil?
+          command.query['quotaUser'] = quota_user unless quota_user.nil?
+          execute_or_queue_command(command, &block)
+        end
+        
         # Lists Connectors in a given project and location.
         # @param [String] parent
         #   Required. Value of parent.

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: google-apis-firebasedataconnect_v1
 version: !ruby/object:Gem::Version
-  version: 0.7.0
+  version: 0.9.0
 platform: ruby
 authors:
 - Google LLC
@@ -57,7 +57,7 @@ licenses:
 metadata:
   bug_tracker_uri: https://github.com/googleapis/google-api-ruby-client/issues
   changelog_uri: https://github.com/googleapis/google-api-ruby-client/tree/main/generated/google-apis-firebasedataconnect_v1/CHANGELOG.md
-  documentation_uri: https://googleapis.dev/ruby/google-apis-firebasedataconnect_v1/v0.7.0
+  documentation_uri: https://googleapis.dev/ruby/google-apis-firebasedataconnect_v1/v0.9.0
   source_code_uri: https://github.com/googleapis/google-api-ruby-client/tree/main/generated/google-apis-firebasedataconnect_v1
 rdoc_options: []
 require_paths: