google-api-client 0.40.0 → 0.41.0

data/generated/google/apis/{dialogflow_v3alpha1 → documentai_v1beta2}/service.rb

@@ -19,20 +19,21 @@ require 'google/apis/errors'
 
 module Google
   module Apis
-    module DialogflowV3alpha1
-      # Dialogflow API
+    module DocumentaiV1beta2
+      # Cloud Document AI API
       #
-      # Builds conversational interfaces (for example, chatbots, and voice-powered
-      #  apps and devices).
+      # Service to parse structured information from unstructured or semi-structured
+      #  documents using state-of-the-art Google AI such as natural language, computer
+      #  vision, translation, and AutoML.
       #
       # @example
-      #    require 'google/apis/dialogflow_v3alpha1'
+      #    require 'google/apis/documentai_v1beta2'
       #
-      #    Dialogflow = Google::Apis::DialogflowV3alpha1 # Alias the module
-      #    service = Dialogflow::DialogflowService.new
+      #    Documentai = Google::Apis::DocumentaiV1beta2 # Alias the module
+      #    service = Documentai::DocumentService.new
       #
-      # @see https://cloud.google.com/dialogflow/
-      class DialogflowService < Google::Apis::Core::BaseService
+      # @see https://cloud.google.com/document-ai/docs/
+      class DocumentService < Google::Apis::Core::BaseService
         # @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.
@@ -44,22 +45,17 @@ module Google
         attr_accessor :quota_user
 
         def initialize
-          super('https://dialogflow.googleapis.com/', '')
+          super('https://documentai.googleapis.com/', '')
           @batch_path = 'batch'
         end
         
-        # Starts asynchronous cancellation on a long-running operation.  The server
-        # makes a best effort to cancel the operation, but success is not
-        # guaranteed.  If the server doesn't support this method, it returns
-        # `google.rpc.Code.UNIMPLEMENTED`.  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`.
-        # @param [String] name
-        #   The name of the operation resource to be cancelled.
+        # LRO endpoint to batch process many documents. The output is written
+        # to Cloud Storage as JSON in the [Document] format.
+        # @param [String] parent
+        #   Target project and location to make a call.
+        #   Format: `projects/`project-id`/locations/`location-id``.
+        #   If no location is specified, a region will be chosen automatically.
+        # @param [Google::Apis::DocumentaiV1beta2::GoogleCloudDocumentaiV1beta2BatchProcessDocumentsRequest] google_cloud_documentai_v1beta2_batch_process_documents_request_object
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
@@ -69,29 +65,33 @@ module Google
         #   Request-specific options
         #
         # @yield [result, err] Result & error if block supplied
-        # @yieldparam result [Google::Apis::DialogflowV3alpha1::GoogleProtobufEmpty] parsed result object
+        # @yieldparam result [Google::Apis::DocumentaiV1beta2::GoogleLongrunningOperation] parsed result object
         # @yieldparam err [StandardError] error object if request failed
         #
-        # @return [Google::Apis::DialogflowV3alpha1::GoogleProtobufEmpty]
+        # @return [Google::Apis::DocumentaiV1beta2::GoogleLongrunningOperation]
         #
         # @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 cancel_project_location_operation(name, fields: nil, quota_user: nil, options: nil, &block)
-          command = make_simple_command(:post, 'v3alpha1/{+name}:cancel', options)
-          command.response_representation = Google::Apis::DialogflowV3alpha1::GoogleProtobufEmpty::Representation
-          command.response_class = Google::Apis::DialogflowV3alpha1::GoogleProtobufEmpty
-          command.params['name'] = name unless name.nil?
+        def batch_project_document_process(parent, google_cloud_documentai_v1beta2_batch_process_documents_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
+          command = make_simple_command(:post, 'v1beta2/{+parent}/documents:batchProcess', options)
+          command.request_representation = Google::Apis::DocumentaiV1beta2::GoogleCloudDocumentaiV1beta2BatchProcessDocumentsRequest::Representation
+          command.request_object = google_cloud_documentai_v1beta2_batch_process_documents_request_object
+          command.response_representation = Google::Apis::DocumentaiV1beta2::GoogleLongrunningOperation::Representation
+          command.response_class = Google::Apis::DocumentaiV1beta2::GoogleLongrunningOperation
+          command.params['parent'] = parent unless parent.nil?
           command.query['fields'] = fields unless fields.nil?
           command.query['quotaUser'] = quota_user unless quota_user.nil?
           execute_or_queue_command(command, &block)
         end
         
-        # Gets the latest state of a long-running operation.  Clients can use this
-        # method to poll the operation result at intervals as recommended by the API
-        # service.
-        # @param [String] name
-        #   The name of the operation resource.
+        # Processes a single document.
+        # @param [String] parent
+        #   Target project and location to make a call.
+        #   Format: `projects/`project-id`/locations/`location-id``.
+        #   If no location is specified, a region will be chosen automatically.
+        #   This field is only populated when used in ProcessDocument method.
+        # @param [Google::Apis::DocumentaiV1beta2::GoogleCloudDocumentaiV1beta2ProcessDocumentRequest] google_cloud_documentai_v1beta2_process_document_request_object
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
@@ -101,41 +101,33 @@ module Google
         #   Request-specific options
         #
         # @yield [result, err] Result & error if block supplied
-        # @yieldparam result [Google::Apis::DialogflowV3alpha1::GoogleLongrunningOperation] parsed result object
+        # @yieldparam result [Google::Apis::DocumentaiV1beta2::GoogleCloudDocumentaiV1beta2Document] parsed result object
         # @yieldparam err [StandardError] error object if request failed
         #
-        # @return [Google::Apis::DialogflowV3alpha1::GoogleLongrunningOperation]
+        # @return [Google::Apis::DocumentaiV1beta2::GoogleCloudDocumentaiV1beta2Document]
         #
         # @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 get_project_location_operation(name, fields: nil, quota_user: nil, options: nil, &block)
-          command = make_simple_command(:get, 'v3alpha1/{+name}', options)
-          command.response_representation = Google::Apis::DialogflowV3alpha1::GoogleLongrunningOperation::Representation
-          command.response_class = Google::Apis::DialogflowV3alpha1::GoogleLongrunningOperation
-          command.params['name'] = name unless name.nil?
+        def process_project_document(parent, google_cloud_documentai_v1beta2_process_document_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
+          command = make_simple_command(:post, 'v1beta2/{+parent}/documents:process', options)
+          command.request_representation = Google::Apis::DocumentaiV1beta2::GoogleCloudDocumentaiV1beta2ProcessDocumentRequest::Representation
+          command.request_object = google_cloud_documentai_v1beta2_process_document_request_object
+          command.response_representation = Google::Apis::DocumentaiV1beta2::GoogleCloudDocumentaiV1beta2Document::Representation
+          command.response_class = Google::Apis::DocumentaiV1beta2::GoogleCloudDocumentaiV1beta2Document
+          command.params['parent'] = parent unless parent.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 operations that match the specified filter in the request. If the
-        # server doesn't support this method, it returns `UNIMPLEMENTED`.
-        # NOTE: the `name` binding allows API services to override the binding
-        # to use different resource name schemes, such as `users/*/operations`. To
-        # override the binding, API services can add a binding such as
-        # `"/v1/`name=users/*`/operations"` to their service configuration.
-        # For backwards compatibility, the default name includes the operations
-        # collection id, however overriding users must ensure the name binding
-        # is the parent resource, without the operations collection id.
-        # @param [String] name
-        #   The name of the operation's parent resource.
-        # @param [String] filter
-        #   The standard list filter.
-        # @param [Fixnum] page_size
-        #   The standard list page size.
-        # @param [String] page_token
-        #   The standard list page token.
+        # LRO endpoint to batch process many documents. The output is written
+        # to Cloud Storage as JSON in the [Document] format.
+        # @param [String] parent
+        #   Target project and location to make a call.
+        #   Format: `projects/`project-id`/locations/`location-id``.
+        #   If no location is specified, a region will be chosen automatically.
+        # @param [Google::Apis::DocumentaiV1beta2::GoogleCloudDocumentaiV1beta2BatchProcessDocumentsRequest] google_cloud_documentai_v1beta2_batch_process_documents_request_object
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
@@ -145,39 +137,33 @@ module Google
         #   Request-specific options
         #
         # @yield [result, err] Result & error if block supplied
-        # @yieldparam result [Google::Apis::DialogflowV3alpha1::GoogleLongrunningListOperationsResponse] parsed result object
+        # @yieldparam result [Google::Apis::DocumentaiV1beta2::GoogleLongrunningOperation] parsed result object
         # @yieldparam err [StandardError] error object if request failed
         #
-        # @return [Google::Apis::DialogflowV3alpha1::GoogleLongrunningListOperationsResponse]
+        # @return [Google::Apis::DocumentaiV1beta2::GoogleLongrunningOperation]
         #
         # @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)
-          command = make_simple_command(:get, 'v3alpha1/{+name}/operations', options)
-          command.response_representation = Google::Apis::DialogflowV3alpha1::GoogleLongrunningListOperationsResponse::Representation
-          command.response_class = Google::Apis::DialogflowV3alpha1::GoogleLongrunningListOperationsResponse
-          command.params['name'] = name unless name.nil?
-          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?
+        def batch_project_location_document_process(parent, google_cloud_documentai_v1beta2_batch_process_documents_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
+          command = make_simple_command(:post, 'v1beta2/{+parent}/documents:batchProcess', options)
+          command.request_representation = Google::Apis::DocumentaiV1beta2::GoogleCloudDocumentaiV1beta2BatchProcessDocumentsRequest::Representation
+          command.request_object = google_cloud_documentai_v1beta2_batch_process_documents_request_object
+          command.response_representation = Google::Apis::DocumentaiV1beta2::GoogleLongrunningOperation::Representation
+          command.response_class = Google::Apis::DocumentaiV1beta2::GoogleLongrunningOperation
+          command.params['parent'] = parent unless parent.nil?
           command.query['fields'] = fields unless fields.nil?
           command.query['quotaUser'] = quota_user unless quota_user.nil?
           execute_or_queue_command(command, &block)
         end
         
-        # Starts asynchronous cancellation on a long-running operation.  The server
-        # makes a best effort to cancel the operation, but success is not
-        # guaranteed.  If the server doesn't support this method, it returns
-        # `google.rpc.Code.UNIMPLEMENTED`.  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`.
-        # @param [String] name
-        #   The name of the operation resource to be cancelled.
+        # Processes a single document.
+        # @param [String] parent
+        #   Target project and location to make a call.
+        #   Format: `projects/`project-id`/locations/`location-id``.
+        #   If no location is specified, a region will be chosen automatically.
+        #   This field is only populated when used in ProcessDocument method.
+        # @param [Google::Apis::DocumentaiV1beta2::GoogleCloudDocumentaiV1beta2ProcessDocumentRequest] google_cloud_documentai_v1beta2_process_document_request_object
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
@@ -187,19 +173,21 @@ module Google
         #   Request-specific options
         #
         # @yield [result, err] Result & error if block supplied
-        # @yieldparam result [Google::Apis::DialogflowV3alpha1::GoogleProtobufEmpty] parsed result object
+        # @yieldparam result [Google::Apis::DocumentaiV1beta2::GoogleCloudDocumentaiV1beta2Document] parsed result object
         # @yieldparam err [StandardError] error object if request failed
         #
-        # @return [Google::Apis::DialogflowV3alpha1::GoogleProtobufEmpty]
+        # @return [Google::Apis::DocumentaiV1beta2::GoogleCloudDocumentaiV1beta2Document]
         #
         # @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 cancel_project_operation(name, fields: nil, quota_user: nil, options: nil, &block)
-          command = make_simple_command(:post, 'v3alpha1/{+name}:cancel', options)
-          command.response_representation = Google::Apis::DialogflowV3alpha1::GoogleProtobufEmpty::Representation
-          command.response_class = Google::Apis::DialogflowV3alpha1::GoogleProtobufEmpty
-          command.params['name'] = name unless name.nil?
+        def process_project_location_document(parent, google_cloud_documentai_v1beta2_process_document_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
+          command = make_simple_command(:post, 'v1beta2/{+parent}/documents:process', options)
+          command.request_representation = Google::Apis::DocumentaiV1beta2::GoogleCloudDocumentaiV1beta2ProcessDocumentRequest::Representation
+          command.request_object = google_cloud_documentai_v1beta2_process_document_request_object
+          command.response_representation = Google::Apis::DocumentaiV1beta2::GoogleCloudDocumentaiV1beta2Document::Representation
+          command.response_class = Google::Apis::DocumentaiV1beta2::GoogleCloudDocumentaiV1beta2Document
+          command.params['parent'] = parent unless parent.nil?
           command.query['fields'] = fields unless fields.nil?
           command.query['quotaUser'] = quota_user unless quota_user.nil?
           execute_or_queue_command(command, &block)
@@ -219,41 +207,29 @@ module Google
         #   Request-specific options
         #
         # @yield [result, err] Result & error if block supplied
-        # @yieldparam result [Google::Apis::DialogflowV3alpha1::GoogleLongrunningOperation] parsed result object
+        # @yieldparam result [Google::Apis::DocumentaiV1beta2::GoogleLongrunningOperation] parsed result object
         # @yieldparam err [StandardError] error object if request failed
         #
-        # @return [Google::Apis::DialogflowV3alpha1::GoogleLongrunningOperation]
+        # @return [Google::Apis::DocumentaiV1beta2::GoogleLongrunningOperation]
         #
         # @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 get_project_operation(name, fields: nil, quota_user: nil, options: nil, &block)
-          command = make_simple_command(:get, 'v3alpha1/{+name}', options)
-          command.response_representation = Google::Apis::DialogflowV3alpha1::GoogleLongrunningOperation::Representation
-          command.response_class = Google::Apis::DialogflowV3alpha1::GoogleLongrunningOperation
+        def get_project_location_operation(name, fields: nil, quota_user: nil, options: nil, &block)
+          command = make_simple_command(:get, 'v1beta2/{+name}', options)
+          command.response_representation = Google::Apis::DocumentaiV1beta2::GoogleLongrunningOperation::Representation
+          command.response_class = Google::Apis::DocumentaiV1beta2::GoogleLongrunningOperation
           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 operations that match the specified filter in the request. If the
-        # server doesn't support this method, it returns `UNIMPLEMENTED`.
-        # NOTE: the `name` binding allows API services to override the binding
-        # to use different resource name schemes, such as `users/*/operations`. To
-        # override the binding, API services can add a binding such as
-        # `"/v1/`name=users/*`/operations"` to their service configuration.
-        # For backwards compatibility, the default name includes the operations
-        # collection id, however overriding users must ensure the name binding
-        # is the parent resource, without the operations collection id.
+        # Gets the latest state of a long-running operation.  Clients can use this
+        # method to poll the operation result at intervals as recommended by the API
+        # service.
         # @param [String] name
-        #   The name of the operation's parent resource.
-        # @param [String] filter
-        #   The standard list filter.
-        # @param [Fixnum] page_size
-        #   The standard list page size.
-        # @param [String] page_token
-        #   The standard list page token.
+        #   The name of the operation resource.
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
@@ -263,22 +239,19 @@ module Google
         #   Request-specific options
         #
         # @yield [result, err] Result & error if block supplied
-        # @yieldparam result [Google::Apis::DialogflowV3alpha1::GoogleLongrunningListOperationsResponse] parsed result object
+        # @yieldparam result [Google::Apis::DocumentaiV1beta2::GoogleLongrunningOperation] parsed result object
         # @yieldparam err [StandardError] error object if request failed
         #
-        # @return [Google::Apis::DialogflowV3alpha1::GoogleLongrunningListOperationsResponse]
+        # @return [Google::Apis::DocumentaiV1beta2::GoogleLongrunningOperation]
         #
         # @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_operations(name, filter: nil, page_size: nil, page_token: nil, fields: nil, quota_user: nil, options: nil, &block)
-          command = make_simple_command(:get, 'v3alpha1/{+name}/operations', options)
-          command.response_representation = Google::Apis::DialogflowV3alpha1::GoogleLongrunningListOperationsResponse::Representation
-          command.response_class = Google::Apis::DialogflowV3alpha1::GoogleLongrunningListOperationsResponse
+        def get_project_operation(name, fields: nil, quota_user: nil, options: nil, &block)
+          command = make_simple_command(:get, 'v1beta2/{+name}', options)
+          command.response_representation = Google::Apis::DocumentaiV1beta2::GoogleLongrunningOperation::Representation
+          command.response_class = Google::Apis::DocumentaiV1beta2::GoogleLongrunningOperation
           command.params['name'] = name unless name.nil?
-          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['fields'] = fields unless fields.nil?
           command.query['quotaUser'] = quota_user unless quota_user.nil?
           execute_or_queue_command(command, &block)

data/generated/google/apis/{dialogflow_v3alpha1.rb → documentai_v1beta2.rb}

@@ -12,27 +12,25 @@
 # See the License for the specific language governing permissions and
 # limitations under the License.
 
-require 'google/apis/dialogflow_v3alpha1/service.rb'
-require 'google/apis/dialogflow_v3alpha1/classes.rb'
-require 'google/apis/dialogflow_v3alpha1/representations.rb'
+require 'google/apis/documentai_v1beta2/service.rb'
+require 'google/apis/documentai_v1beta2/classes.rb'
+require 'google/apis/documentai_v1beta2/representations.rb'
 
 module Google
   module Apis
-    # Dialogflow API
+    # Cloud Document AI API
     #
-    # Builds conversational interfaces (for example, chatbots, and voice-powered
-    # apps and devices).
+    # Service to parse structured information from unstructured or semi-structured
+    # documents using state-of-the-art Google AI such as natural language, computer
+    # vision, translation, and AutoML.
     #
-    # @see https://cloud.google.com/dialogflow/
-    module DialogflowV3alpha1
-      VERSION = 'V3alpha1'
-      REVISION = '20200526'
+    # @see https://cloud.google.com/document-ai/docs/
+    module DocumentaiV1beta2
+      VERSION = 'V1beta2'
+      REVISION = '20200612'
 
       # View and manage your data across Google Cloud Platform services
       AUTH_CLOUD_PLATFORM = 'https://www.googleapis.com/auth/cloud-platform'
-
-      # View, manage and query your Dialogflow agents
-      AUTH_DIALOGFLOW = 'https://www.googleapis.com/auth/dialogflow'
     end
   end
 end