google-apis-datalineage_v1 0.3.0 → 0.5.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 93d88e4456debacf6eafedc439519b82d876b54e3408d18089a3c7e6e16136fb
-  data.tar.gz: 8367456d1f9807328a6d058829f3740996774ca79fcb939af488b2ad282036db
+  metadata.gz: a5505feb1e591f7e8dea8e0e07326c9db3f6cfa0b1967e2cac920cb2ff3cfd91
+  data.tar.gz: c7bc7119af6dbcc51cd5cea741f1ee2da56ddfc223980af9adeac9ccec9fed8c
 SHA512:
-  metadata.gz: 9e77b70cf932d42d47d535361731781e6013556d99d6089143bd77173fd174abd1a11544e657e17694846ae50b3223f778be82634226ec804e3b872ddd36d691
-  data.tar.gz: bf7bf8ff66baf2d29d1336b6feff5195bd4f994e0bf3942c50d81489b5444f019a0c2442792e3566c19fb0045ef830a17f472f9c2d9e400e310aab55422c83ab
+  metadata.gz: cc98fa894f6256a4351116b051dac82c3027aa54e47e7da05b2a6c9201aa39bd4951043d71e2eb6980171a1b037dbeb5ee1ae264d6dad5ca4a0351fb5f724467
+  data.tar.gz: d2c5016acc3eea448206ccd21f1fc9c2b31b2a84fbc2d899d3a7b7a8275a67070eea69e51b4bd7447b7794d249a44b96cf7cb454a9a62273e20e04591cc8ba4f

data/CHANGELOG.md

@@ -1,5 +1,14 @@
 # Release history for google-apis-datalineage_v1
 
+### v0.5.0 (2025-01-08)
+
+* Regenerated from discovery document revision 20241202
+* Regenerated using generator version 0.15.1
+
+### v0.4.0 (2023-07-02)
+
+* Regenerated from discovery document revision 20230623
+
 ### v0.3.0 (2023-05-28)
 
 * Regenerated from discovery document revision 20230519

data/OVERVIEW.md

@@ -83,9 +83,9 @@ The [product documentation](https://cloud.google.com/data-catalog) may provide g
 
 ## Supported Ruby versions
 
-This library is supported on Ruby 2.5+.
+This library is supported on Ruby 2.7+.
 
-Google provides official support for Ruby versions that are actively supported by Ruby Core -- that is, Ruby versions that are either in normal maintenance or in security maintenance, and not end of life. Currently, this means Ruby 2.5 and later. Older versions of Ruby _may_ still work, but are unsupported and not recommended. See https://www.ruby-lang.org/en/downloads/branches/ for details about the Ruby support schedule.
+Google provides official support for Ruby versions that are actively supported by Ruby Core -- that is, Ruby versions that are either in normal maintenance or in security maintenance, and not end of life. Older versions of Ruby _may_ still work, but are unsupported and not recommended. See https://www.ruby-lang.org/en/downloads/branches/ for details about the Ruby support schedule.
 
 ## License
 

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

@@ -157,7 +157,7 @@ module Google
         # @return [String]
         attr_accessor :name
       
-        # Optional. The beginning of the transformation which resulted in this lineage
+        # Required. The beginning of the transformation which resulted in this lineage
         # event. For streaming scenarios, it should be the beginning of the period from
         # which the lineage is being reported.
         # Corresponds to the JSON property `startTime`
@@ -368,8 +368,9 @@ module Google
         attr_accessor :name
       
         # Type of the source. Use of a source_type other than `CUSTOM` for process
-        # creation or updating is highly discouraged, and may be restricted in the
-        # future without notice.
+        # creation or updating is highly discouraged. It might be restricted in the
+        # future without notice. There will be increase in cost if you use any of the
+        # source types other than `CUSTOM`.
         # Corresponds to the JSON property `sourceType`
         # @return [String]
         attr_accessor :source_type
@@ -490,6 +491,40 @@ module Google
         end
       end
       
+      # Response message for ProcessOpenLineageRunEvent.
+      class GoogleCloudDatacatalogLineageV1ProcessOpenLineageRunEventResponse
+        include Google::Apis::Core::Hashable
+      
+        # Created lineage event names. Format: `projects/`project`/locations/`location`/
+        # processes/`process`/runs/`run`/lineageEvents/`lineage_event``.
+        # Corresponds to the JSON property `lineageEvents`
+        # @return [Array<String>]
+        attr_accessor :lineage_events
+      
+        # Created process name. Format: `projects/`project`/locations/`location`/
+        # processes/`process``.
+        # Corresponds to the JSON property `process`
+        # @return [String]
+        attr_accessor :process
+      
+        # Created run name. Format: `projects/`project`/locations/`location`/processes/`
+        # process`/runs/`run``.
+        # Corresponds to the JSON property `run`
+        # @return [String]
+        attr_accessor :run
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @lineage_events = args[:lineage_events] if args.key?(:lineage_events)
+          @process = args[:process] if args.key?(:process)
+          @run = args[:run] if args.key?(:run)
+        end
+      end
+      
       # A lineage run represents an execution of a process that creates lineage events.
       class GoogleCloudDatacatalogLineageV1Run
         include Google::Apis::Core::Hashable
@@ -691,13 +726,13 @@ module Google
         # @return [String]
         attr_accessor :name
       
-        # The normal response of the operation in case of success. If the original
-        # method returns no data on success, such as `Delete`, the response is `google.
-        # protobuf.Empty`. If the original method is standard `Get`/`Create`/`Update`,
-        # the response should be the resource. For other methods, the response should
-        # have the type `XxxResponse`, where `Xxx` is the original method name. For
-        # example, if the original method name is `TakeSnapshot()`, the inferred
-        # response type is `TakeSnapshotResponse`.
+        # The normal, successful response of the operation. If the original method
+        # returns no data on success, such as `Delete`, the response is `google.protobuf.
+        # Empty`. If the original method is standard `Get`/`Create`/`Update`, the
+        # response should be the resource. For other methods, the response should have
+        # the type `XxxResponse`, where `Xxx` is the original method name. For example,
+        # if the original method name is `TakeSnapshot()`, the inferred response type is
+        # `TakeSnapshotResponse`.
         # Corresponds to the JSON property `response`
         # @return [Hash<String,Object>]
         attr_accessor :response

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

@@ -16,13 +16,13 @@ module Google
   module Apis
     module DatalineageV1
       # Version of the google-apis-datalineage_v1 gem
-      GEM_VERSION = "0.3.0"
+      GEM_VERSION = "0.5.0"
 
       # Version of the code generator used to generate this client
-      GENERATOR_VERSION = "0.12.0"
+      GENERATOR_VERSION = "0.15.1"
 
       # Revision of the discovery document this client was generated from
-      REVISION = "20230519"
+      REVISION = "20241202"
     end
   end
 end

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

@@ -106,6 +106,12 @@ module Google
         include Google::Apis::Core::JsonObjectSupport
       end
       
+      class GoogleCloudDatacatalogLineageV1ProcessOpenLineageRunEventResponse
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      
+        include Google::Apis::Core::JsonObjectSupport
+      end
+      
       class GoogleCloudDatacatalogLineageV1Run
         class Representation < Google::Apis::Core::JsonRepresentation; end
       
@@ -289,6 +295,15 @@ module Google
         end
       end
       
+      class GoogleCloudDatacatalogLineageV1ProcessOpenLineageRunEventResponse
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+          collection :lineage_events, as: 'lineageEvents'
+          property :process, as: 'process'
+          property :run, as: 'run'
+        end
+      end
+      
       class GoogleCloudDatacatalogLineageV1Run
         # @private
         class Representation < Google::Apis::Core::JsonRepresentation

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

@@ -32,6 +32,8 @@ module Google
       #
       # @see https://cloud.google.com/data-catalog
       class DatalineageService < Google::Apis::Core::BaseService
+        DEFAULT_ENDPOINT_TEMPLATE = "https://datalineage.$UNIVERSE_DOMAIN$/"
+
         # @return [String]
         #  API key. Your API key identifies your project and provides you with API access,
         #  quota, and reports. Required unless you provide an OAuth 2.0 token.
@@ -43,7 +45,7 @@ module Google
         attr_accessor :quota_user
 
         def initialize
-          super('https://datalineage.googleapis.com/', '',
+          super(DEFAULT_ENDPOINT_TEMPLATE, '',
                 client_name: 'google-apis-datalineage_v1',
                 client_version: Google::Apis::DatalineageV1::GEM_VERSION)
           @batch_path = 'batch'
@@ -90,6 +92,45 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
+        # Creates new lineage events together with their parents: process and run.
+        # Updates the process and run if they already exist. Mapped from Open Lineage
+        # specification: https://github.com/OpenLineage/OpenLineage/blob/main/spec/
+        # OpenLineage.json.
+        # @param [String] parent
+        #   Required. The name of the project and its location that should own the process,
+        #   run, and lineage event.
+        # @param [String] request_id
+        #   A unique identifier for this request. Restricted to 36 ASCII characters. A
+        #   random UUID is recommended. This request is idempotent only if a `request_id`
+        #   is provided.
+        # @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::DatalineageV1::GoogleCloudDatacatalogLineageV1ProcessOpenLineageRunEventResponse] parsed result object
+        # @yieldparam err [StandardError] error object if request failed
+        #
+        # @return [Google::Apis::DatalineageV1::GoogleCloudDatacatalogLineageV1ProcessOpenLineageRunEventResponse]
+        #
+        # @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 process_project_location_open_lineage_run_event(parent, request_id: nil, fields: nil, quota_user: nil, options: nil, &block)
+          command = make_simple_command(:post, 'v1/{+parent}:processOpenLineageRunEvent', options)
+          command.response_representation = Google::Apis::DatalineageV1::GoogleCloudDatacatalogLineageV1ProcessOpenLineageRunEventResponse::Representation
+          command.response_class = Google::Apis::DatalineageV1::GoogleCloudDatacatalogLineageV1ProcessOpenLineageRunEventResponse
+          command.params['parent'] = parent unless parent.nil?
+          command.query['requestId'] = request_id unless request_id.nil?
+          command.query['fields'] = fields unless fields.nil?
+          command.query['quotaUser'] = quota_user unless quota_user.nil?
+          execute_or_queue_command(command, &block)
+        end
+        
         # Retrieve a list of links connected to a specific asset. Links represent the
         # data flow between **source** (upstream) and **target** (downstream) assets in
         # transformation pipelines. Links are stored in the same project as the Lineage
@@ -134,8 +175,8 @@ module Google
         # Clients can use Operations.GetOperation or other methods to check whether the
         # cancellation succeeded or whether the operation completed despite cancellation.
         # On successful cancellation, the operation is not deleted; instead, it becomes
-        # an operation with an Operation.error value with a google.rpc.Status.code of 1,
-        # corresponding to `Code.CANCELLED`.
+        # an operation with an Operation.error value with a google.rpc.Status.code of `1`
+        # , corresponding to `Code.CANCELLED`.
         # @param [String] name
         #   The name of the operation resource to be cancelled.
         # @param [Google::Apis::DatalineageV1::GoogleLongrunningCancelOperationRequest] google_longrunning_cancel_operation_request_object

metadata

@@ -1,14 +1,13 @@
 --- !ruby/object:Gem::Specification
 name: google-apis-datalineage_v1
 version: !ruby/object:Gem::Version
-  version: 0.3.0
+  version: 0.5.0
 platform: ruby
 authors:
 - Google LLC
-autorequire: 
 bindir: bin
 cert_chain: []
-date: 2023-05-28 00:00:00.000000000 Z
+date: 2025-01-12 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: google-apis-core
@@ -16,7 +15,7 @@ dependencies:
     requirements:
     - - ">="
       - !ruby/object:Gem::Version
-        version: 0.11.0
+        version: 0.15.0
     - - "<"
       - !ruby/object:Gem::Version
         version: 2.a
@@ -26,7 +25,7 @@ dependencies:
     requirements:
     - - ">="
       - !ruby/object:Gem::Version
-        version: 0.11.0
+        version: 0.15.0
     - - "<"
       - !ruby/object:Gem::Version
         version: 2.a
@@ -58,9 +57,8 @@ 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-datalineage_v1/CHANGELOG.md
-  documentation_uri: https://googleapis.dev/ruby/google-apis-datalineage_v1/v0.3.0
+  documentation_uri: https://googleapis.dev/ruby/google-apis-datalineage_v1/v0.5.0
   source_code_uri: https://github.com/googleapis/google-api-ruby-client/tree/main/generated/google-apis-datalineage_v1
-post_install_message: 
 rdoc_options: []
 require_paths:
 - lib
@@ -68,15 +66,14 @@ required_ruby_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
-      version: '2.5'
+      version: '2.7'
 required_rubygems_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.4.2
-signing_key: 
+rubygems_version: 3.6.2
 specification_version: 4
 summary: Simple REST client for Data Lineage API V1
 test_files: []