# frozen_string_literal: true

# Copyright 2022 Google LLC
#
# Licensed under the Apache License, Version 2.0 (the "License");
# you may not use this file except in compliance with the License.
# You may obtain a copy of the License at
#
#     https://www.apache.org/licenses/LICENSE-2.0
#
# Unless required by applicable law or agreed to in writing, software
# distributed under the License is distributed on an "AS IS" BASIS,
# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
# See the License for the specific language governing permissions and
# limitations under the License.

# Auto-generated by gapic-generator-ruby. DO NOT EDIT!


module Google
  module Cloud
    module Retail
      module V2
        # Request for CreateControl method.
        # @!attribute [rw] parent
        #   @return [::String]
        #     Required. Full resource name of parent catalog. Format:
        #     `projects/{project_number}/locations/{location_id}/catalogs/{catalog_id}`
        # @!attribute [rw] control
        #   @return [::Google::Cloud::Retail::V2::Control]
        #     Required. The Control to create.
        # @!attribute [rw] control_id
        #   @return [::String]
        #     Required. The ID to use for the Control, which will become the final
        #     component of the Control's resource name.
        #
        #     This value should be 4-63 characters, and valid characters
        #     are /[a-z][0-9]-_/.
        class CreateControlRequest
          include ::Google::Protobuf::MessageExts
          extend ::Google::Protobuf::MessageExts::ClassMethods
        end

        # Request for UpdateControl method.
        # @!attribute [rw] control
        #   @return [::Google::Cloud::Retail::V2::Control]
        #     Required. The Control to update.
        # @!attribute [rw] update_mask
        #   @return [::Google::Protobuf::FieldMask]
        #     Indicates which fields in the provided
        #     {::Google::Cloud::Retail::V2::Control Control} to update. The following are NOT
        #     supported:
        #
        #     * {::Google::Cloud::Retail::V2::Control#name Control.name}
        #
        #     If not set or empty, all supported fields are updated.
        class UpdateControlRequest
          include ::Google::Protobuf::MessageExts
          extend ::Google::Protobuf::MessageExts::ClassMethods
        end

        # Request for DeleteControl method.
        # @!attribute [rw] name
        #   @return [::String]
        #     Required. The resource name of the Control to delete. Format:
        #     `projects/{project_number}/locations/{location_id}/catalogs/{catalog_id}/controls/{control_id}`
        class DeleteControlRequest
          include ::Google::Protobuf::MessageExts
          extend ::Google::Protobuf::MessageExts::ClassMethods
        end

        # Request for GetControl method.
        # @!attribute [rw] name
        #   @return [::String]
        #     Required. The resource name of the Control to get. Format:
        #     `projects/{project_number}/locations/{location_id}/catalogs/{catalog_id}/controls/{control_id}`
        class GetControlRequest
          include ::Google::Protobuf::MessageExts
          extend ::Google::Protobuf::MessageExts::ClassMethods
        end

        # Request for ListControls method.
        # @!attribute [rw] parent
        #   @return [::String]
        #     Required. The catalog resource name. Format:
        #     `projects/{project_number}/locations/{location_id}/catalogs/{catalog_id}`
        # @!attribute [rw] page_size
        #   @return [::Integer]
        #     Optional. Maximum number of results to return. If unspecified, defaults
        #     to 50. Max allowed value is 1000.
        # @!attribute [rw] page_token
        #   @return [::String]
        #     Optional. A page token, received from a previous `ListControls` call.
        #     Provide this to retrieve the subsequent page.
        # @!attribute [rw] filter
        #   @return [::String]
        #     Optional. A filter to apply on the list results. Supported features:
        #
        #     * List all the products under the parent branch if
        #     {::Google::Cloud::Retail::V2::ListControlsRequest#filter filter} is unset.
        #     * List controls that are used in a single ServingConfig:
        #         'serving_config = "boosted_home_page_cvr"'
        class ListControlsRequest
          include ::Google::Protobuf::MessageExts
          extend ::Google::Protobuf::MessageExts::ClassMethods
        end

        # Response for ListControls method.
        # @!attribute [rw] controls
        #   @return [::Array<::Google::Cloud::Retail::V2::Control>]
        #     All the Controls for a given catalog.
        # @!attribute [rw] next_page_token
        #   @return [::String]
        #     Pagination token, if not returned indicates the last page.
        class ListControlsResponse
          include ::Google::Protobuf::MessageExts
          extend ::Google::Protobuf::MessageExts::ClassMethods
        end
      end
    end
  end
end