google-api-client 0.43.0 → 0.44.0

data/generated/google/apis/realtimebidding_v1.rb

@@ -28,7 +28,7 @@ module Google
     # @see https://developers.google.com/authorized-buyers/apis/realtimebidding/reference/rest/
     module RealtimebiddingV1
       VERSION = 'V1'
-      REVISION = '20200803'
+      REVISION = '20200822'
 
       # See, create, edit, and delete your Authorized Buyers and Open Bidding account entities
       AUTH_REALTIME_BIDDING = 'https://www.googleapis.com/auth/realtime-bidding'

data/generated/google/apis/recommendationengine_v1beta1.rb

@@ -27,7 +27,7 @@ module Google
     # @see https://cloud.google.com/recommendations-ai/docs
     module RecommendationengineV1beta1
       VERSION = 'V1beta1'
-      REVISION = '20200728'
+      REVISION = '20200810'
 
       # View and manage your data across Google Cloud Platform services
       AUTH_CLOUD_PLATFORM = 'https://www.googleapis.com/auth/cloud-platform'

data/generated/google/apis/recommendationengine_v1beta1/classes.rb

@@ -23,34 +23,21 @@ module Google
     module RecommendationengineV1beta1
       
       # Message that represents an arbitrary HTTP body. It should only be used for
-      # payload formats that can't be represented as JSON, such as raw binary or
-      # an HTML page.
-      # This message can be used both in streaming and non-streaming API methods in
-      # the request as well as the response.
-      # It can be used as a top-level request field, which is convenient if one
-      # wants to extract parameters from either the URL or HTTP template into the
-      # request fields and also want access to the raw HTTP body.
-      # Example:
-      # message GetResourceRequest `
-      # // A unique request id.
-      # string request_id = 1;
-      # // The raw HTTP body is bound to this field.
-      # google.api.HttpBody http_body = 2;
-      # `
-      # service ResourceService `
-      # rpc GetResource(GetResourceRequest) returns (google.api.HttpBody);
-      # rpc UpdateResource(google.api.HttpBody) returns
-      # (google.protobuf.Empty);
-      # `
-      # Example with streaming methods:
-      # service CaldavService `
-      # rpc GetCalendar(stream google.api.HttpBody)
-      # returns (stream google.api.HttpBody);
-      # rpc UpdateCalendar(stream google.api.HttpBody)
-      # returns (stream google.api.HttpBody);
-      # `
-      # Use of this type only changes how the request and response bodies are
-      # handled, all other features will continue to work unchanged.
+      # payload formats that can't be represented as JSON, such as raw binary or an
+      # HTML page. This message can be used both in streaming and non-streaming API
+      # methods in the request as well as the response. It can be used as a top-level
+      # request field, which is convenient if one wants to extract parameters from
+      # either the URL or HTTP template into the request fields and also want access
+      # to the raw HTTP body. Example: message GetResourceRequest ` // A unique
+      # request id. string request_id = 1; // The raw HTTP body is bound to this field.
+      # google.api.HttpBody http_body = 2; ` service ResourceService ` rpc
+      # GetResource(GetResourceRequest) returns (google.api.HttpBody); rpc
+      # UpdateResource(google.api.HttpBody) returns (google.protobuf.Empty); ` Example
+      # with streaming methods: service CaldavService ` rpc GetCalendar(stream google.
+      # api.HttpBody) returns (stream google.api.HttpBody); rpc UpdateCalendar(stream
+      # google.api.HttpBody) returns (stream google.api.HttpBody); ` Use of this type
+      # only changes how the request and response bodies are handled, all other
+      # features will continue to work unchanged.
       class GoogleApiHttpBody
         include Google::Apis::Core::Hashable
       
@@ -65,8 +52,8 @@ module Google
         # @return [String]
         attr_accessor :data
       
-        # Application specific response metadata. Must be set in the first response
-        # for streaming APIs.
+        # Application specific response metadata. Must be set in the first response for
+        # streaming APIs.
         # Corresponds to the JSON property `extensions`
         # @return [Array<Hash<String,Object>>]
         attr_accessor :extensions
@@ -120,9 +107,8 @@ module Google
         include Google::Apis::Core::Hashable
       
         # The resource name of the recommendation model that this tune applies to.
-        # Format:
-        # projects/`project_number`/locations/`location_id`/catalogs/`catalog_id`/
-        # eventStores/`event_store_id`/recommendationModels/`recommendation_model_id`
+        # Format: projects/`project_number`/locations/`location_id`/catalogs/`catalog_id`
+        # /eventStores/`event_store_id`/recommendationModels/`recommendation_model_id`
         # Corresponds to the JSON property `recommendationModel`
         # @return [String]
         attr_accessor :recommendation_model
@@ -154,17 +140,15 @@ module Google
       class GoogleCloudRecommendationengineV1beta1BigQuerySource
         include Google::Apis::Core::Hashable
       
-        # Optional. The schema to use when parsing the data from the source.
-        # Supported values for catalog imports:
-        # 1: "catalog_recommendations_ai" using
-        # https://cloud.google.com/recommendations-ai/docs/upload-catalog#json
-        # (Default for catalogItems.import)
-        # 2: "catalog_merchant_center" using
-        # https://cloud.google.com/recommendations-ai/docs/upload-catalog#mc
-        # Supported values for user event imports:
-        # 1: "user_events_recommendations_ai" using
-        # https://cloud.google.com/recommendations-ai/docs/manage-user-events#import
-        # (Default for userEvents.import)
+        # Optional. The schema to use when parsing the data from the source. Supported
+        # values for catalog imports: 1: "catalog_recommendations_ai" using https://
+        # cloud.google.com/recommendations-ai/docs/upload-catalog#json (Default for
+        # catalogItems.import) 2: "catalog_merchant_center" using https://cloud.google.
+        # com/recommendations-ai/docs/upload-catalog#mc Supported values for user event
+        # imports: 1: "user_events_recommendations_ai" using https://cloud.google.com/
+        # recommendations-ai/docs/manage-user-events#import (Default for userEvents.
+        # import) 2. "user_events_ga360" using https://support.google.com/analytics/
+        # answer/3437719?hl=en
         # Corresponds to the JSON property `dataSchema`
         # @return [String]
         attr_accessor :data_schema
@@ -175,16 +159,14 @@ module Google
         attr_accessor :dataset_id
       
         # Optional. Intermediate Cloud Storage directory used for the import. Can be
-        # specified
-        # if one wants to have the BigQuery export to a specific Cloud Storage
+        # specified if one wants to have the BigQuery export to a specific Cloud Storage
         # directory.
         # Corresponds to the JSON property `gcsStagingDir`
         # @return [String]
         attr_accessor :gcs_staging_dir
       
         # Optional. The project id (can be project # or id) that the BigQuery source is
-        # in. If
-        # not specified, inherits the project id from the parent request.
+        # in. If not specified, inherits the project id from the parent request.
         # Corresponds to the JSON property `projectId`
         # @return [String]
         attr_accessor :project_id
@@ -208,18 +190,17 @@ module Google
         end
       end
       
-      # The catalog configuration.
-      # Next ID: 5.
+      # The catalog configuration. Next ID: 5.
       class GoogleCloudRecommendationengineV1beta1Catalog
         include Google::Apis::Core::Hashable
       
-        # Configures what level the catalog should be uploaded with regards to
-        # how users will be send events and how predictions will be made.
+        # Configures the catalog level that users send events to, and the level at which
+        # predictions are made.
         # Corresponds to the JSON property `catalogItemLevelConfig`
         # @return [Google::Apis::RecommendationengineV1beta1::GoogleCloudRecommendationengineV1beta1CatalogItemLevelConfig]
         attr_accessor :catalog_item_level_config
       
-        # Required. The id of the default event store.
+        # Required. The ID of the default event store.
         # Corresponds to the JSON property `defaultEventStoreId`
         # @return [String]
         attr_accessor :default_event_store_id
@@ -271,31 +252,26 @@ module Google
       class GoogleCloudRecommendationengineV1beta1CatalogItem
         include Google::Apis::Core::Hashable
       
-        # Required. Catalog item categories. This field is repeated for supporting
-        # one catalog item belonging to several parallel category hierarchies.
-        # For example, if a shoes product belongs to both
-        # ["Shoes & Accessories" -> "Shoes"] and
-        # ["Sports & Fitness" -> "Athletic Clothing" -> "Shoes"], it could be
-        # represented as:
-        # "categoryHierarchies": [
-        # ` "categories": ["Shoes & Accessories", "Shoes"]`,
-        # ` "categories": ["Sports & Fitness", "Athletic Clothing", "Shoes"] `
-        # ]
+        # Required. Catalog item categories. This field is repeated for supporting one
+        # catalog item belonging to several parallel category hierarchies. For example,
+        # if a shoes product belongs to both ["Shoes & Accessories" -> "Shoes"] and ["
+        # Sports & Fitness" -> "Athletic Clothing" -> "Shoes"], it could be represented
+        # as: "categoryHierarchies": [ ` "categories": ["Shoes & Accessories", "Shoes"]`,
+        # ` "categories": ["Sports & Fitness", "Athletic Clothing", "Shoes"] ` ]
         # Corresponds to the JSON property `categoryHierarchies`
         # @return [Array<Google::Apis::RecommendationengineV1beta1::GoogleCloudRecommendationengineV1beta1CatalogItemCategoryHierarchy>]
         attr_accessor :category_hierarchies
       
-        # Optional. Catalog item description. UTF-8 encoded string with a length
-        # limit of 5 KiB.
+        # Optional. Catalog item description. UTF-8 encoded string with a length limit
+        # of 5 KiB.
         # Corresponds to the JSON property `description`
         # @return [String]
         attr_accessor :description
       
-        # Required. Catalog item identifier. UTF-8 encoded string with a length limit
-        # of 128 bytes.
-        # This id must be unique among all catalog items within the same catalog. It
-        # should also be used when logging user events in order for the user events
-        # to be joined with the Catalog.
+        # Required. Catalog item identifier. UTF-8 encoded string with a length limit of
+        # 128 bytes. This id must be unique among all catalog items within the same
+        # catalog. It should also be used when logging user events in order for the user
+        # events to be joined with the Catalog.
         # Corresponds to the JSON property `id`
         # @return [String]
         attr_accessor :id
@@ -308,17 +284,15 @@ module Google
         attr_accessor :item_attributes
       
         # Optional. Variant group identifier for prediction results. UTF-8 encoded
-        # string with a length limit of 128 bytes.
-        # This field must be enabled before it can be used. [Learn
-        # more](/recommendations-ai/docs/catalog#item-group-id).
+        # string with a length limit of 128 bytes. This field must be enabled before it
+        # can be used. [Learn more](/recommendations-ai/docs/catalog#item-group-id).
         # Corresponds to the JSON property `itemGroupId`
         # @return [String]
         attr_accessor :item_group_id
       
         # Optional. Deprecated. The model automatically detects the text language. Your
-        # catalog can include text in different languages, but duplicating
-        # catalog items to provide text in multiple languages can result in
-        # degraded model performance.
+        # catalog can include text in different languages, but duplicating catalog items
+        # to provide text in multiple languages can result in degraded model performance.
         # Corresponds to the JSON property `languageCode`
         # @return [String]
         attr_accessor :language_code
@@ -328,10 +302,10 @@ module Google
         # @return [Google::Apis::RecommendationengineV1beta1::GoogleCloudRecommendationengineV1beta1ProductCatalogItem]
         attr_accessor :product_metadata
       
-        # Optional. Filtering tags associated with the catalog item. Each tag should
-        # be a UTF-8 encoded string with a length limit of 1 KiB.
-        # This tag can be used for filtering recommendation results by passing the
-        # tag as part of the predict request filter.
+        # Optional. Filtering tags associated with the catalog item. Each tag should be
+        # a UTF-8 encoded string with a length limit of 1 KiB. This tag can be used for
+        # filtering recommendation results by passing the tag as part of the predict
+        # request filter.
         # Corresponds to the JSON property `tags`
         # @return [Array<String>]
         attr_accessor :tags
@@ -364,10 +338,9 @@ module Google
       class GoogleCloudRecommendationengineV1beta1CatalogItemCategoryHierarchy
         include Google::Apis::Core::Hashable
       
-        # Required. Catalog item categories. Each category should be a UTF-8
-        # encoded string with a length limit of 2 KiB.
-        # Note that the order in the list denotes the specificity (from least to
-        # most specific).
+        # Required. Catalog item categories. Each category should be a UTF-8 encoded
+        # string with a length limit of 2 KiB. Note that the order in the list denotes
+        # the specificity (from least to most specific).
         # Corresponds to the JSON property `categories`
         # @return [Array<String>]
         attr_accessor :categories
@@ -382,21 +355,20 @@ module Google
         end
       end
       
-      # Configures what level the catalog should be uploaded with regards to
-      # how users will be send events and how predictions will be made.
+      # Configures the catalog level that users send events to, and the level at which
+      # predictions are made.
       class GoogleCloudRecommendationengineV1beta1CatalogItemLevelConfig
         include Google::Apis::Core::Hashable
       
-        # Optional. What level of the catalog are events uploaded at.
-        # See https://cloud.google.com/recommendations-ai/docs/catalog#catalog-levels
-        # for more details.
+        # Optional. Level of the catalog at which events are uploaded. See https://cloud.
+        # google.com/recommendations-ai/docs/catalog#catalog-levels for more details.
         # Corresponds to the JSON property `eventItemLevel`
         # @return [String]
         attr_accessor :event_item_level
       
-        # Optional. What level of the catalog are predictions made at.
-        # See https://cloud.google.com/recommendations-ai/docs/catalog#catalog-levels
-        # for more details.
+        # Optional. Level of the catalog at which predictions are made. See https://
+        # cloud.google.com/recommendations-ai/docs/catalog#catalog-levels for more
+        # details.
         # Corresponds to the JSON property `predictItemLevel`
         # @return [String]
         attr_accessor :predict_item_level
@@ -442,50 +414,47 @@ module Google
         # @return [Google::Apis::RecommendationengineV1beta1::GoogleCloudRecommendationengineV1beta1FeatureMap]
         attr_accessor :event_attributes
       
-        # Optional. A list of identifiers for the independent experiment groups
-        # this user event belongs to. This is used to distinguish between user events
-        # associated with different experiment setups (e.g. using Recommendation
-        # Engine system, using different recommendation models).
+        # Optional. A list of identifiers for the independent experiment groups this
+        # user event belongs to. This is used to distinguish between user events
+        # associated with different experiment setups (e.g. using Recommendation Engine
+        # system, using different recommendation models).
         # Corresponds to the JSON property `experimentIds`
         # @return [Array<String>]
         attr_accessor :experiment_ids
       
-        # Optional. A unique id of a web page view.
-        # This should be kept the same for all user events triggered from the same
-        # pageview. For example, an item detail page view could trigger multiple
-        # events as the user is browsing the page.
-        # The `pageViewId` property should be kept the same for all these events so
-        # that they can be grouped together properly. This `pageViewId` will be
-        # automatically generated if using the JavaScript pixel.
+        # Optional. A unique id of a web page view. This should be kept the same for all
+        # user events triggered from the same pageview. For example, an item detail page
+        # view could trigger multiple events as the user is browsing the page. The `
+        # pageViewId` property should be kept the same for all these events so that they
+        # can be grouped together properly. This `pageViewId` will be automatically
+        # generated if using the JavaScript pixel.
         # Corresponds to the JSON property `pageViewId`
         # @return [String]
         attr_accessor :page_view_id
       
         # Optional. Recommendation token included in the recommendation prediction
-        # response.
-        # This field enables accurate attribution of recommendation model
-        # performance.
-        # This token enables us to accurately attribute page view or purchase back to
-        # the event and the particular predict response containing this
+        # response. This field enables accurate attribution of recommendation model
+        # performance. This token enables us to accurately attribute page view or
+        # purchase back to the event and the particular predict response containing this
         # clicked/purchased item. If user clicks on product K in the recommendation
         # results, pass the `PredictResponse.recommendationToken` property as a url
-        # parameter to product K's page. When recording events on product K's page,
-        # log the PredictResponse.recommendation_token to this field.
-        # Optional, but highly encouraged for user events that are the result of a
-        # recommendation prediction query.
+        # parameter to product K's page. When recording events on product K's page, log
+        # the PredictResponse.recommendation_token to this field. Optional, but highly
+        # encouraged for user events that are the result of a recommendation prediction
+        # query.
         # Corresponds to the JSON property `recommendationToken`
         # @return [String]
         attr_accessor :recommendation_token
       
-        # Optional. The referrer url of the current page. When using
-        # the JavaScript pixel, this value is filled in automatically.
+        # Optional. The referrer url of the current page. When using the JavaScript
+        # pixel, this value is filled in automatically.
         # Corresponds to the JSON property `referrerUri`
         # @return [String]
         attr_accessor :referrer_uri
       
-        # Optional. Complete url (window.location.href) of the user's current page.
-        # When using the JavaScript pixel, this value is filled in automatically.
-        # Maximum length 5KB.
+        # Optional. Complete url (window.location.href) of the user's current page. When
+        # using the JavaScript pixel, this value is filled in automatically. Maximum
+        # length 5KB.
         # Corresponds to the JSON property `uri`
         # @return [String]
         attr_accessor :uri
@@ -512,20 +481,16 @@ module Google
         include Google::Apis::Core::Hashable
       
         # Categorical features that can take on one of a limited number of possible
-        # values. Some examples would be the brand/maker of a product, or country of
-        # a customer.
-        # Feature names and values must be UTF-8 encoded strings.
-        # For example: `` "colors": `"value": ["yellow", "green"]`,
-        # "sizes": `"value":["S", "M"]``
+        # values. Some examples would be the brand/maker of a product, or country of a
+        # customer. Feature names and values must be UTF-8 encoded strings. For example:
+        # `` "colors": `"value": ["yellow", "green"]`, "sizes": `"value":["S", "M"]``
         # Corresponds to the JSON property `categoricalFeatures`
         # @return [Hash<String,Google::Apis::RecommendationengineV1beta1::GoogleCloudRecommendationengineV1beta1FeatureMapStringList>]
         attr_accessor :categorical_features
       
-        # Numerical features. Some examples would be the height/weight of a product,
-        # or age of a customer.
-        # Feature names must be UTF-8 encoded strings.
-        # For example: `` "lengths_cm": `"value":[2.3, 15.4]`,
-        # "heights_cm": `"value":[8.1, 6.4]` ``
+        # Numerical features. Some examples would be the height/weight of a product, or
+        # age of a customer. Feature names must be UTF-8 encoded strings. For example: ``
+        # "lengths_cm": `"value":[2.3, 15.4]`, "heights_cm": `"value":[8.1, 6.4]` ``
         # Corresponds to the JSON property `numericalFeatures`
         # @return [Hash<String,Google::Apis::RecommendationengineV1beta1::GoogleCloudRecommendationengineV1beta1FeatureMapFloatList>]
         attr_accessor :numerical_features
@@ -579,33 +544,29 @@ module Google
         end
       end
       
-      # Google Cloud Storage location for input content.
-      # format.
+      # Google Cloud Storage location for input content. format.
       class GoogleCloudRecommendationengineV1beta1GcsSource
         include Google::Apis::Core::Hashable
       
-        # Required. Google Cloud Storage URIs to input files. URI can be up to
-        # 2000 characters long. URIs can match the full object path (for example,
-        # gs://bucket/directory/object.json) or a pattern matching one or more
-        # files, such as gs://bucket/directory/*.json. A request can
-        # contain at most 100 files, and each file can be up to 2 GB. See
-        # [Importing catalog information](/recommendations-ai/docs/upload-catalog)
-        # for the expected file format and setup instructions.
+        # Required. Google Cloud Storage URIs to input files. URI can be up to 2000
+        # characters long. URIs can match the full object path (for example, gs://bucket/
+        # directory/object.json) or a pattern matching one or more files, such as gs://
+        # bucket/directory/*.json. A request can contain at most 100 files, and each
+        # file can be up to 2 GB. See [Importing catalog information](/recommendations-
+        # ai/docs/upload-catalog) for the expected file format and setup instructions.
         # Corresponds to the JSON property `inputUris`
         # @return [Array<String>]
         attr_accessor :input_uris
       
-        # Optional. The schema to use when parsing the data from the source.
-        # Supported values for catalog imports:
-        # 1: "catalog_recommendations_ai" using
-        # https://cloud.google.com/recommendations-ai/docs/upload-catalog#json
-        # (Default for catalogItems.import)
-        # 2: "catalog_merchant_center" using
-        # https://cloud.google.com/recommendations-ai/docs/upload-catalog#mc
-        # Supported values for user events imports:
-        # 1: "user_events_recommendations_ai" using
-        # https://cloud.google.com/recommendations-ai/docs/manage-user-events#import
-        # (Default for userEvents.import)
+        # Optional. The schema to use when parsing the data from the source. Supported
+        # values for catalog imports: 1: "catalog_recommendations_ai" using https://
+        # cloud.google.com/recommendations-ai/docs/upload-catalog#json (Default for
+        # catalogItems.import) 2: "catalog_merchant_center" using https://cloud.google.
+        # com/recommendations-ai/docs/upload-catalog#mc Supported values for user events
+        # imports: 1: "user_events_recommendations_ai" using https://cloud.google.com/
+        # recommendations-ai/docs/manage-user-events#import (Default for userEvents.
+        # import) 2. "user_events_ga360" using https://support.google.com/analytics/
+        # answer/3437719?hl=en
         # Corresponds to the JSON property `jsonSchema`
         # @return [String]
         attr_accessor :json_schema
@@ -621,31 +582,6 @@ module Google
         end
       end
       
-      # Response message for GetCatalogItemsWithItemGroupId method.
-      class GoogleCloudRecommendationengineV1beta1GetCatalogItemsWithItemGroupIdResponse
-        include Google::Apis::Core::Hashable
-      
-        # CatalogItem captures all metadata information of items to be recommended.
-        # Corresponds to the JSON property `canonicalCatalogItem`
-        # @return [Google::Apis::RecommendationengineV1beta1::GoogleCloudRecommendationengineV1beta1CatalogItem]
-        attr_accessor :canonical_catalog_item
-      
-        # The list of catalog items associated with the item group id.
-        # Corresponds to the JSON property `catalogItems`
-        # @return [Array<Google::Apis::RecommendationengineV1beta1::GoogleCloudRecommendationengineV1beta1CatalogItem>]
-        attr_accessor :catalog_items
-      
-        def initialize(**args)
-           update!(**args)
-        end
-      
-        # Update properties of this object
-        def update!(**args)
-          @canonical_catalog_item = args[:canonical_catalog_item] if args.key?(:canonical_catalog_item)
-          @catalog_items = args[:catalog_items] if args.key?(:catalog_items)
-        end
-      end
-      
       # Catalog item thumbnail/detail image.
       class GoogleCloudRecommendationengineV1beta1Image
         include Google::Apis::Core::Hashable
@@ -691,17 +627,16 @@ module Google
         # @return [Google::Apis::RecommendationengineV1beta1::GoogleCloudRecommendationengineV1beta1InputConfig]
         attr_accessor :input_config
       
-        # Optional. Unique identifier provided by client, within the ancestor
-        # dataset scope. Ensures idempotency and used for request deduplication.
-        # Server-generated if unspecified. Up to 128 characters long. This is
-        # returned as google.longrunning.Operation.name in the response.
+        # Optional. Unique identifier provided by client, within the ancestor dataset
+        # scope. Ensures idempotency and used for request deduplication. Server-
+        # generated if unspecified. Up to 128 characters long. This is returned as
+        # google.longrunning.Operation.name in the response.
         # Corresponds to the JSON property `requestId`
         # @return [String]
         attr_accessor :request_id
       
         # Optional. Indicates which fields in the provided imported 'items' to update.
-        # If not
-        # set, will by default update all fields.
+        # If not set, will by default update all fields.
         # Corresponds to the JSON property `updateMask`
         # @return [String]
         attr_accessor :update_mask
@@ -719,9 +654,9 @@ module Google
         end
       end
       
-      # Response of the ImportCatalogItemsRequest. If the long running
-      # operation is done, then this message is returned by the
-      # google.longrunning.Operations.response field if the operation was successful.
+      # Response of the ImportCatalogItemsRequest. If the long running operation is
+      # done, then this message is returned by the google.longrunning.Operations.
+      # response field if the operation was successful.
       class GoogleCloudRecommendationengineV1beta1ImportCatalogItemsResponse
         include Google::Apis::Core::Hashable
       
@@ -750,10 +685,9 @@ module Google
       class GoogleCloudRecommendationengineV1beta1ImportErrorsConfig
         include Google::Apis::Core::Hashable
       
-        # Google Cloud Storage path for import errors. This must be an empty,
-        # existing Cloud Storage bucket. Import errors will be written to a file in
-        # this bucket, one per line, as a JSON-encoded
-        # `google.rpc.Status` message.
+        # Google Cloud Storage path for import errors. This must be an empty, existing
+        # Cloud Storage bucket. Import errors will be written to a file in this bucket,
+        # one per line, as a JSON-encoded `google.rpc.Status` message.
         # Corresponds to the JSON property `gcsPrefix`
         # @return [String]
         attr_accessor :gcs_prefix
@@ -788,8 +722,8 @@ module Google
         # @return [String]
         attr_accessor :operation_name
       
-        # Id of the request / operation. This is parroting back the requestId that
-        # was passed in the request.
+        # Id of the request / operation. This is parroting back the requestId that was
+        # passed in the request.
         # Corresponds to the JSON property `requestId`
         # @return [String]
         attr_accessor :request_id
@@ -799,8 +733,8 @@ module Google
         # @return [Fixnum]
         attr_accessor :success_count
       
-        # Operation last update time. If the operation is done, this is also the
-        # finish time.
+        # Operation last update time. If the operation is done, this is also the finish
+        # time.
         # Corresponds to the JSON property `updateTime`
         # @return [String]
         attr_accessor :update_time
@@ -834,12 +768,11 @@ module Google
         # @return [Google::Apis::RecommendationengineV1beta1::GoogleCloudRecommendationengineV1beta1InputConfig]
         attr_accessor :input_config
       
-        # Optional. Unique identifier provided by client, within the ancestor
-        # dataset scope. Ensures idempotency for expensive long running operations.
-        # Server-generated if unspecified. Up to 128 characters long. This is
-        # returned as google.longrunning.Operation.name in the response. Note that
-        # this field must not be set if the desired input config is
-        # catalog_inline_source.
+        # Optional. Unique identifier provided by client, within the ancestor dataset
+        # scope. Ensures idempotency for expensive long running operations. Server-
+        # generated if unspecified. Up to 128 characters long. This is returned as
+        # google.longrunning.Operation.name in the response. Note that this field must
+        # not be set if the desired input config is catalog_inline_source.
         # Corresponds to the JSON property `requestId`
         # @return [String]
         attr_accessor :request_id
@@ -856,9 +789,9 @@ module Google
         end
       end
       
-      # Response of the ImportUserEventsRequest. If the long running
-      # operation was successful, then this message is returned by the
-      # google.longrunning.Operations.response field if the operation was successful.
+      # Response of the ImportUserEventsRequest. If the long running operation was
+      # successful, then this message is returned by the google.longrunning.Operations.
+      # response field if the operation was successful.
       class GoogleCloudRecommendationengineV1beta1ImportUserEventsResponse
         include Google::Apis::Core::Hashable
       
@@ -872,8 +805,8 @@ module Google
         # @return [Google::Apis::RecommendationengineV1beta1::GoogleCloudRecommendationengineV1beta1ImportErrorsConfig]
         attr_accessor :errors_config
       
-        # A summary of import result. The UserEventImportSummary summarizes
-        # the import status for user events.
+        # A summary of import result. The UserEventImportSummary summarizes the import
+        # status for user events.
         # Corresponds to the JSON property `importSummary`
         # @return [Google::Apis::RecommendationengineV1beta1::GoogleCloudRecommendationengineV1beta1UserEventImportSummary]
         attr_accessor :import_summary
@@ -904,8 +837,7 @@ module Google
         # @return [Google::Apis::RecommendationengineV1beta1::GoogleCloudRecommendationengineV1beta1CatalogInlineSource]
         attr_accessor :catalog_inline_source
       
-        # Google Cloud Storage location for input content.
-        # format.
+        # Google Cloud Storage location for input content. format.
         # Corresponds to the JSON property `gcsSource`
         # @return [Google::Apis::RecommendationengineV1beta1::GoogleCloudRecommendationengineV1beta1GcsSource]
         attr_accessor :gcs_source
@@ -1035,50 +967,44 @@ module Google
       class GoogleCloudRecommendationengineV1beta1PredictRequest
         include Google::Apis::Core::Hashable
       
-        # Optional. Use dryRun mode for this prediction query. If set to true, a
-        # dummy model will be used that returns arbitrary catalog items.
-        # Note that the dryRun mode should only be used for testing the API, or if
-        # the model is not ready.
+        # Optional. Use dryRun mode for this prediction query. If set to true, a dummy
+        # model will be used that returns arbitrary catalog items. Note that the dryRun
+        # mode should only be used for testing the API, or if the model is not ready.
         # Corresponds to the JSON property `dryRun`
         # @return [Boolean]
         attr_accessor :dry_run
         alias_method :dry_run?, :dry_run
       
-        # Optional. Filter for restricting prediction results. Accepts values for
-        # tags and the `filterOutOfStockItems` flag.
-        # * Tag expressions. Restricts predictions to items that match all of the
-        # specified tags. Boolean operators `OR` and `NOT` are supported if the
-        # expression is enclosed in parentheses, and must be separated from the
-        # tag values by a space. `-"tagA"` is also supported and is equivalent to
-        # `NOT "tagA"`. Tag values must be double quoted UTF-8 encoded strings
-        # with a size limit of 1 KiB.
-        # * filterOutOfStockItems. Restricts predictions to items that do not have a
-        # stockState value of OUT_OF_STOCK.
-        # Examples:
-        # * tag=("Red" OR "Blue") tag="New-Arrival" tag=(NOT "promotional")
-        # * filterOutOfStockItems  tag=(-"promotional")
-        # * filterOutOfStockItems
-        # If your filter blocks all prediction results, nothing will be returned. If
-        # you want generic (unfiltered) popular items to be returned instead, set
-        # `strictFiltering` to false in `PredictRequest.params`.
+        # Optional. Filter for restricting prediction results. Accepts values for tags
+        # and the `filterOutOfStockItems` flag. * Tag expressions. Restricts predictions
+        # to items that match all of the specified tags. Boolean operators `OR` and `NOT`
+        # are supported if the expression is enclosed in parentheses, and must be
+        # separated from the tag values by a space. `-"tagA"` is also supported and is
+        # equivalent to `NOT "tagA"`. Tag values must be double quoted UTF-8 encoded
+        # strings with a size limit of 1 KiB. * filterOutOfStockItems. Restricts
+        # predictions to items that do not have a stockState value of OUT_OF_STOCK.
+        # Examples: * tag=("Red" OR "Blue") tag="New-Arrival" tag=(NOT "promotional") *
+        # filterOutOfStockItems tag=(-"promotional") * filterOutOfStockItems If your
+        # filter blocks all prediction results, nothing will be returned. If you want
+        # generic (unfiltered) popular items to be returned instead, set `
+        # strictFiltering` to false in `PredictRequest.params`.
         # Corresponds to the JSON property `filter`
         # @return [String]
         attr_accessor :filter
       
-        # Optional. The labels for the predict request.
-        # * Label keys can contain lowercase letters, digits and hyphens, must start
-        # with a letter, and must end with a letter or digit.
-        # * Non-zero label values can contain lowercase letters, digits and hyphens,
-        # must start with a letter, and must end with a letter or digit.
-        # * No more than 64 labels can be associated with a given request.
-        # See https://goo.gl/xmQnxf for more information on and examples of labels.
+        # Optional. The labels for the predict request. * Label keys can contain
+        # lowercase letters, digits and hyphens, must start with a letter, and must end
+        # with a letter or digit. * Non-zero label values can contain lowercase letters,
+        # digits and hyphens, must start with a letter, and must end with a letter or
+        # digit. * No more than 64 labels can be associated with a given request. See
+        # https://goo.gl/xmQnxf for more information on and examples of labels.
         # Corresponds to the JSON property `labels`
         # @return [Hash<String,String>]
         attr_accessor :labels
       
-        # Optional. Maximum number of results to return per page. Set this property
-        # to the number of prediction results required. If zero, the service will
-        # choose a reasonable default.
+        # Optional. Maximum number of results to return per page. Set this property to
+        # the number of prediction results required. If zero, the service will choose a
+        # reasonable default.
         # Corresponds to the JSON property `pageSize`
         # @return [Fixnum]
         attr_accessor :page_size
@@ -1088,20 +1014,16 @@ module Google
         # @return [String]
         attr_accessor :page_token
       
-        # Optional. Additional domain specific parameters for the predictions.
-        # Allowed values:
-        # * `returnCatalogItem`: Boolean. If set to true, the associated catalogItem
-        # object will be returned in the
-        # `PredictResponse.PredictionResult.itemMetadata` object in the method
-        # response.
-        # * `returnItemScore`: Boolean. If set to true, the prediction 'score'
-        # corresponding to each returned item will be set in the `metadata`
-        # field in the prediction response. The given 'score' indicates the
-        # probability of an item being clicked/purchased given the user's context
-        # and history.
-        # * `strictFiltering`: Boolean. True by default. If set to false, the service
-        # will return generic (unfiltered) popular items instead of empty if your
-        # filter blocks all prediction results.
+        # Optional. Additional domain specific parameters for the predictions. Allowed
+        # values: * `returnCatalogItem`: Boolean. If set to true, the associated
+        # catalogItem object will be returned in the `PredictResponse.PredictionResult.
+        # itemMetadata` object in the method response. * `returnItemScore`: Boolean. If
+        # set to true, the prediction 'score' corresponding to each returned item will
+        # be set in the `metadata` field in the prediction response. The given 'score'
+        # indicates the probability of an item being clicked/purchased given the user's
+        # context and history. * `strictFiltering`: Boolean. True by default. If set to
+        # false, the service will return generic (unfiltered) popular items instead of
+        # empty if your filter blocks all prediction results.
         # Corresponds to the JSON property `params`
         # @return [Hash<String,Object>]
         attr_accessor :params
@@ -1154,15 +1076,15 @@ module Google
         # @return [String]
         attr_accessor :next_page_token
       
-        # A unique recommendation token. This should be included in the user event
-        # logs resulting from this recommendation, which enables accurate attribution
-        # of recommendation model performance.
+        # A unique recommendation token. This should be included in the user event logs
+        # resulting from this recommendation, which enables accurate attribution of
+        # recommendation model performance.
         # Corresponds to the JSON property `recommendationToken`
         # @return [String]
         attr_accessor :recommendation_token
       
-        # A list of recommended items. The order represents the ranking (from the
-        # most relevant item to the least).
+        # A list of recommended items. The order represents the ranking (from the most
+        # relevant item to the least).
         # Corresponds to the JSON property `results`
         # @return [Array<Google::Apis::RecommendationengineV1beta1::GoogleCloudRecommendationengineV1beta1PredictResponsePredictionResult>]
         attr_accessor :results
@@ -1191,12 +1113,11 @@ module Google
         # @return [String]
         attr_accessor :id
       
-        # Additional item metadata / annotations.
-        # Possible values:
-        # * `catalogItem`: JSON representation of the catalogItem. Will be set if
-        # `returnCatalogItem` is set to true in `PredictRequest.params`.
-        # * `score`: Prediction score in double value. Will be set if
-        # `returnItemScore` is set to true in `PredictRequest.params`.
+        # Additional item metadata / annotations. Possible values: * `catalogItem`: JSON
+        # representation of the catalogItem. Will be set if `returnCatalogItem` is set
+        # to true in `PredictRequest.params`. * `score`: Prediction score in double
+        # value. Will be set if `returnItemScore` is set to true in `PredictRequest.
+        # params`.
         # Corresponds to the JSON property `itemMetadata`
         # @return [Hash<String,Object>]
         attr_accessor :item_metadata
@@ -1240,25 +1161,22 @@ module Google
         # @return [Fixnum]
         attr_accessor :available_quantity
       
-        # Optional. Canonical URL directly linking to the item detail page with a
-        # length limit of 5 KiB..
+        # Optional. Canonical URL directly linking to the item detail page with a length
+        # limit of 5 KiB..
         # Corresponds to the JSON property `canonicalProductUri`
         # @return [String]
         attr_accessor :canonical_product_uri
       
-        # Optional. A map to pass the costs associated with the product.
-        # For example:
-        # `"manufacturing": 45.5` The profit of selling this item is computed like
-        # so:
-        # * If 'exactPrice' is provided, profit = displayPrice - sum(costs)
-        # * If 'priceRange' is provided, profit = minPrice - sum(costs)
+        # Optional. A map to pass the costs associated with the product. For example: `"
+        # manufacturing": 45.5` The profit of selling this item is computed like so: *
+        # If 'exactPrice' is provided, profit = displayPrice - sum(costs) * If '
+        # priceRange' is provided, profit = minPrice - sum(costs)
         # Corresponds to the JSON property `costs`
         # @return [Hash<String,Float>]
         attr_accessor :costs
       
         # Optional. Only required if the price is set. Currency code for price/costs.
-        # Use
-        # three-character ISO-4217 code.
+        # Use three-character ISO-4217 code.
         # Corresponds to the JSON property `currencyCode`
         # @return [String]
         attr_accessor :currency_code
@@ -1273,8 +1191,8 @@ module Google
         # @return [Array<Google::Apis::RecommendationengineV1beta1::GoogleCloudRecommendationengineV1beta1Image>]
         attr_accessor :images
       
-        # Product price range when there are a range of prices for different
-        # variations of the same product.
+        # Product price range when there are a range of prices for different variations
+        # of the same product.
         # Corresponds to the JSON property `priceRange`
         # @return [Google::Apis::RecommendationengineV1beta1::GoogleCloudRecommendationengineV1beta1ProductCatalogItemPriceRange]
         attr_accessor :price_range
@@ -1310,8 +1228,8 @@ module Google
         # @return [Float]
         attr_accessor :display_price
       
-        # Optional. Price of the product without any discount. If zero, by default
-        # set to be the 'displayPrice'.
+        # Optional. Price of the product without any discount. If zero, by default set
+        # to be the 'displayPrice'.
         # Corresponds to the JSON property `originalPrice`
         # @return [Float]
         attr_accessor :original_price
@@ -1327,8 +1245,8 @@ module Google
         end
       end
       
-      # Product price range when there are a range of prices for different
-      # variations of the same product.
+      # Product price range when there are a range of prices for different variations
+      # of the same product.
       class GoogleCloudRecommendationengineV1beta1ProductCatalogItemPriceRange
         include Google::Apis::Core::Hashable
       
@@ -1359,22 +1277,22 @@ module Google
       
         # Optional. Quantity of the products in stock when a user event happens.
         # Optional. If provided, this overrides the available quantity in Catalog for
-        # this event. and can only be set if `stock_status` is set to `IN_STOCK`.
-        # Note that if an item is out of stock, you must set the `stock_state` field
-        # to be `OUT_OF_STOCK`. Leaving this field unspecified / as zero is not
-        # sufficient to mark the item out of stock.
+        # this event. and can only be set if `stock_status` is set to `IN_STOCK`. Note
+        # that if an item is out of stock, you must set the `stock_state` field to be `
+        # OUT_OF_STOCK`. Leaving this field unspecified / as zero is not sufficient to
+        # mark the item out of stock.
         # Corresponds to the JSON property `availableQuantity`
         # @return [Fixnum]
         attr_accessor :available_quantity
       
-        # Optional. Currency code for price/costs. Use three-character ISO-4217
-        # code. Required only if originalPrice or displayPrice is set.
+        # Optional. Currency code for price/costs. Use three-character ISO-4217 code.
+        # Required only if originalPrice or displayPrice is set.
         # Corresponds to the JSON property `currencyCode`
         # @return [String]
         attr_accessor :currency_code
       
-        # Optional. Display price of the product (e.g. discounted price). If
-        # provided, this will override the display price in Catalog for this product.
+        # Optional. Display price of the product (e.g. discounted price). If provided,
+        # this will override the display price in Catalog for this product.
         # Corresponds to the JSON property `displayPrice`
         # @return [Float]
         attr_accessor :display_price
@@ -1392,23 +1310,22 @@ module Google
         # @return [Google::Apis::RecommendationengineV1beta1::GoogleCloudRecommendationengineV1beta1FeatureMap]
         attr_accessor :item_attributes
       
-        # Optional. Original price of the product. If provided, this will override
-        # the original price in Catalog for this product.
+        # Optional. Original price of the product. If provided, this will override the
+        # original price in Catalog for this product.
         # Corresponds to the JSON property `originalPrice`
         # @return [Float]
         attr_accessor :original_price
       
-        # Optional. Quantity of the product associated with the user event. For
-        # example, this field will be 2 if two products are added to the shopping
-        # cart for `add-to-cart` event. Required for `add-to-cart`, `add-to-list`,
-        # `remove-from-cart`, `checkout-start`, `purchase-complete`, `refund` event
-        # types.
+        # Optional. Quantity of the product associated with the user event. For example,
+        # this field will be 2 if two products are added to the shopping cart for `add-
+        # to-cart` event. Required for `add-to-cart`, `add-to-list`, `remove-from-cart`,
+        # `checkout-start`, `purchase-complete`, `refund` event types.
         # Corresponds to the JSON property `quantity`
         # @return [Fixnum]
         attr_accessor :quantity
       
-        # Optional. Item stock state. If provided, this overrides the stock state
-        # in Catalog for items in this event.
+        # Optional. Item stock state. If provided, this overrides the stock state in
+        # Catalog for items in this event.
         # Corresponds to the JSON property `stockState`
         # @return [String]
         attr_accessor :stock_state
@@ -1430,15 +1347,14 @@ module Google
         end
       end
       
-      # ProductEventDetail captures user event information specific to retail
-      # products.
+      # ProductEventDetail captures user event information specific to retail products.
       class GoogleCloudRecommendationengineV1beta1ProductEventDetail
         include Google::Apis::Core::Hashable
       
-        # Optional. The id or name of the associated shopping cart. This id is used
-        # to associate multiple items added or present in the cart before purchase.
-        # This can only be set for `add-to-cart`, `remove-from-cart`,
-        # `checkout-start`, `purchase-complete`, or `shopping-cart-page-view` events.
+        # Optional. The id or name of the associated shopping cart. This id is used to
+        # associate multiple items added or present in the cart before purchase. This
+        # can only be set for `add-to-cart`, `remove-from-cart`, `checkout-start`, `
+        # purchase-complete`, or `shopping-cart-page-view` events.
         # Corresponds to the JSON property `cartId`
         # @return [String]
         attr_accessor :cart_id
@@ -1451,39 +1367,27 @@ module Google
         attr_accessor :list_id
       
         # Required for `category-page-view` events. Other event types should not set
-        # this field.
-        # The categories associated with a category page.
-        # Category pages include special pages such as sales or promotions. For
-        # instance, a special sale page may have the category hierarchy:
-        # categories : ["Sales", "2017 Black Friday Deals"].
+        # this field. The categories associated with a category page. Category pages
+        # include special pages such as sales or promotions. For instance, a special
+        # sale page may have the category hierarchy: categories : ["Sales", "2017 Black
+        # Friday Deals"].
         # Corresponds to the JSON property `pageCategories`
         # @return [Array<Google::Apis::RecommendationengineV1beta1::GoogleCloudRecommendationengineV1beta1CatalogItemCategoryHierarchy>]
         attr_accessor :page_categories
       
-        # The main product details related to the event.
-        # This field is required for the following event types:
-        # * `add-to-cart`
-        # * `add-to-list`
-        # * `checkout-start`
-        # * `detail-page-view`
-        # * `purchase-complete`
-        # * `refund`
-        # * `remove-from-cart`
-        # * `remove-from-list`
-        # This field is optional for the following event types:
-        # * `page-visit`
-        # * `shopping-cart-page-view` - note that 'product_details' should be set for
-        # this unless the shopping cart is empty.
-        # * `search` (highly encouraged)
-        # In a `search` event, this field represents the products returned to the end
-        # user on the current page (the end user may have not finished broswing the
-        # whole page yet). When a new page is returned to the end user, after
-        # pagination/filtering/ordering even for the same query, a new SEARCH event
-        # with different product_details is desired. The end user may have not
-        # finished broswing the whole page yet.
-        # This field is not allowed for the following event types:
-        # * `category-page-view`
-        # * `home-page-view`
+        # The main product details related to the event. This field is required for the
+        # following event types: * `add-to-cart` * `add-to-list` * `checkout-start` * `
+        # detail-page-view` * `purchase-complete` * `refund` * `remove-from-cart` * `
+        # remove-from-list` This field is optional for the following event types: * `
+        # page-visit` * `shopping-cart-page-view` - note that 'product_details' should
+        # be set for this unless the shopping cart is empty. * `search` (highly
+        # encouraged) In a `search` event, this field represents the products returned
+        # to the end user on the current page (the end user may have not finished
+        # broswing the whole page yet). When a new page is returned to the end user,
+        # after pagination/filtering/ordering even for the same query, a new SEARCH
+        # event with different product_details is desired. The end user may have not
+        # finished broswing the whole page yet. This field is not allowed for the
+        # following event types: * `category-page-view` * `home-page-view`
         # Corresponds to the JSON property `productDetails`
         # @return [Array<Google::Apis::RecommendationengineV1beta1::GoogleCloudRecommendationengineV1beta1ProductDetail>]
         attr_accessor :product_details
@@ -1493,8 +1397,8 @@ module Google
         # @return [Google::Apis::RecommendationengineV1beta1::GoogleCloudRecommendationengineV1beta1PurchaseTransaction]
         attr_accessor :purchase_transaction
       
-        # Required for `search` events. Other event types should not set this field.
-        # The user's search query as UTF-8 encoded text with a length limit of 5 KiB.
+        # Required for `search` events. Other event types should not set this field. The
+        # user's search query as UTF-8 encoded text with a length limit of 5 KiB.
         # Corresponds to the JSON property `searchQuery`
         # @return [String]
         attr_accessor :search_query
@@ -1519,20 +1423,17 @@ module Google
         include Google::Apis::Core::Hashable
       
         # Optional. All the costs associated with the product. These can be
-        # manufacturing costs, shipping expenses not borne by the end user, or any
-        # other costs.
-        # Total product cost such that
-        # profit = revenue - (sum(taxes) + sum(costs))
-        # If product_cost is not set, then
-        # profit = revenue - tax - shipping - sum(CatalogItem.costs).
-        # If CatalogItem.cost is not specified for one of the items, CatalogItem.cost
-        # based profit *cannot* be calculated for this Transaction.
+        # manufacturing costs, shipping expenses not borne by the end user, or any other
+        # costs. Total product cost such that profit = revenue - (sum(taxes) + sum(costs)
+        # ) If product_cost is not set, then profit = revenue - tax - shipping - sum(
+        # CatalogItem.costs). If CatalogItem.cost is not specified for one of the items,
+        # CatalogItem.cost based profit *cannot* be calculated for this Transaction.
         # Corresponds to the JSON property `costs`
         # @return [Hash<String,Float>]
         attr_accessor :costs
       
-        # Required. Currency code. Use three-character ISO-4217 code. This field
-        # is not required if the event type is `refund`.
+        # Required. Currency code. Use three-character ISO-4217 code. This field is not
+        # required if the event type is `refund`.
         # Corresponds to the JSON property `currencyCode`
         # @return [String]
         attr_accessor :currency_code
@@ -1542,10 +1443,10 @@ module Google
         # @return [String]
         attr_accessor :id
       
-        # Required. Total revenue or grand total associated with the transaction.
-        # This value include shipping, tax, or other adjustments to total revenue
-        # that you want to include as part of your revenue calculations. This field
-        # is not required if the event type is `refund`.
+        # Required. Total revenue or grand total associated with the transaction. This
+        # value include shipping, tax, or other adjustments to total revenue that you
+        # want to include as part of your revenue calculations. This field is not
+        # required if the event type is `refund`.
         # Corresponds to the JSON property `revenue`
         # @return [Float]
         attr_accessor :revenue
@@ -1569,8 +1470,8 @@ module Google
         end
       end
       
-      # Metadata related to the progress of the PurgeUserEvents operation.
-      # This will be returned by the google.longrunning.Operation.metadata field.
+      # Metadata related to the progress of the PurgeUserEvents operation. This will
+      # be returned by the google.longrunning.Operation.metadata field.
       class GoogleCloudRecommendationengineV1beta1PurgeUserEventsMetadata
         include Google::Apis::Core::Hashable
       
@@ -1599,31 +1500,24 @@ module Google
       class GoogleCloudRecommendationengineV1beta1PurgeUserEventsRequest
         include Google::Apis::Core::Hashable
       
-        # Required. The filter string to specify the events to be deleted. Empty
-        # string filter is not allowed. The eligible fields
-        # for filtering are:
-        # * `eventType`: UserEvent.eventType field of type string.
-        # * `eventTime`: in ISO 8601 "zulu" format.
-        # * `visitorId`: field of type string. Specifying this will delete all
-        # events associated with a visitor.
-        # * `userId`: field of type string. Specifying this will delete all events
-        # associated with a user.
-        # Examples:
-        # * Deleting all events in a time range:
-        # `eventTime > "2012-04-23T18:25:43.511Z"
-        # eventTime < "2012-04-23T18:30:43.511Z"`
-        # * Deleting specific eventType in time range:
-        # `eventTime > "2012-04-23T18:25:43.511Z" eventType = "detail-page-view"`
-        # * Deleting all events for a specific visitor:
-        # `visitorId = "visitor1024"`
-        # The filtering fields are assumed to have an implicit AND.
+        # Required. The filter string to specify the events to be deleted. Empty string
+        # filter is not allowed. The eligible fields for filtering are: * `eventType`:
+        # UserEvent.eventType field of type string. * `eventTime`: in ISO 8601 "zulu"
+        # format. * `visitorId`: field of type string. Specifying this will delete all
+        # events associated with a visitor. * `userId`: field of type string. Specifying
+        # this will delete all events associated with a user. Examples: * Deleting all
+        # events in a time range: `eventTime > "2012-04-23T18:25:43.511Z" eventTime < "
+        # 2012-04-23T18:30:43.511Z"` * Deleting specific eventType in time range: `
+        # eventTime > "2012-04-23T18:25:43.511Z" eventType = "detail-page-view"` *
+        # Deleting all events for a specific visitor: `visitorId = "visitor1024"` The
+        # filtering fields are assumed to have an implicit AND.
         # Corresponds to the JSON property `filter`
         # @return [String]
         attr_accessor :filter
       
-        # Optional. The default value is false. Override this flag to true to
-        # actually perform the purge. If the field is not set to true, a sampling of
-        # events to be deleted will be returned.
+        # Optional. The default value is false. Override this flag to true to actually
+        # perform the purge. If the field is not set to true, a sampling of events to be
+        # deleted will be returned.
         # Corresponds to the JSON property `force`
         # @return [Boolean]
         attr_accessor :force
@@ -1641,8 +1535,8 @@ module Google
       end
       
       # Response of the PurgeUserEventsRequest. If the long running operation is
-      # successfully done, then this message is returned by the
-      # google.longrunning.Operations.response field.
+      # successfully done, then this message is returned by the google.longrunning.
+      # Operations.response field.
       class GoogleCloudRecommendationengineV1beta1PurgeUserEventsResponse
         include Google::Apis::Core::Hashable
       
@@ -1673,8 +1567,7 @@ module Google
         include Google::Apis::Core::Hashable
       
         # Required. The type of the catalog rejoin to define the scope and range of the
-        # user
-        # events to be rejoined with catalog items.
+        # user events to be rejoined with catalog items.
         # Corresponds to the JSON property `userEventRejoinScope`
         # @return [String]
         attr_accessor :user_event_rejoin_scope
@@ -1699,41 +1592,34 @@ module Google
         # @return [Google::Apis::RecommendationengineV1beta1::GoogleCloudRecommendationengineV1beta1EventDetail]
         attr_accessor :event_detail
       
-        # Optional. This field should *not* be set when using JavaScript pixel
-        # or the Recommendations AI Tag. Defaults to `EVENT_SOURCE_UNSPECIFIED`.
+        # Optional. This field should *not* be set when using JavaScript pixel or the
+        # Recommendations AI Tag. Defaults to `EVENT_SOURCE_UNSPECIFIED`.
         # Corresponds to the JSON property `eventSource`
         # @return [String]
         attr_accessor :event_source
       
-        # Optional. Only required for ImportUserEvents method. Timestamp of user
-        # event created.
+        # Optional. Only required for ImportUserEvents method. Timestamp of user event
+        # created.
         # Corresponds to the JSON property `eventTime`
         # @return [String]
         attr_accessor :event_time
       
-        # Required. User event type. Allowed values are:
-        # * `add-to-cart` Products being added to cart.
-        # * `add-to-list` Items being added to a list (shopping list, favorites
-        # etc).
-        # * `category-page-view` Special pages such as sale or promotion pages
-        # viewed.
-        # * `checkout-start` User starting a checkout process.
-        # * `detail-page-view` Products detail page viewed.
-        # * `home-page-view` Homepage viewed.
-        # * `page-visit` Generic page visits not included in the event types above.
-        # * `purchase-complete` User finishing a purchase.
-        # * `refund` Purchased items being refunded or returned.
-        # * `remove-from-cart` Products being removed from cart.
-        # * `remove-from-list` Items being removed from a list.
-        # * `search` Product search.
-        # * `shopping-cart-page-view` User viewing a shopping cart.
-        # * `impression` List of items displayed. Used by Google Tag Manager.
+        # Required. User event type. Allowed values are: * `add-to-cart` Products being
+        # added to cart. * `add-to-list` Items being added to a list (shopping list,
+        # favorites etc). * `category-page-view` Special pages such as sale or promotion
+        # pages viewed. * `checkout-start` User starting a checkout process. * `detail-
+        # page-view` Products detail page viewed. * `home-page-view` Homepage viewed. * `
+        # page-visit` Generic page visits not included in the event types above. * `
+        # purchase-complete` User finishing a purchase. * `refund` Purchased items being
+        # refunded or returned. * `remove-from-cart` Products being removed from cart. *
+        # `remove-from-list` Items being removed from a list. * `search` Product search.
+        # * `shopping-cart-page-view` User viewing a shopping cart. * `impression` List
+        # of items displayed. Used by Google Tag Manager.
         # Corresponds to the JSON property `eventType`
         # @return [String]
         attr_accessor :event_type
       
-        # ProductEventDetail captures user event information specific to retail
-        # products.
+        # ProductEventDetail captures user event information specific to retail products.
         # Corresponds to the JSON property `productEventDetail`
         # @return [Google::Apis::RecommendationengineV1beta1::GoogleCloudRecommendationengineV1beta1ProductEventDetail]
         attr_accessor :product_event_detail
@@ -1758,8 +1644,8 @@ module Google
         end
       end
       
-      # A summary of import result. The UserEventImportSummary summarizes
-      # the import status for user events.
+      # A summary of import result. The UserEventImportSummary summarizes the import
+      # status for user events.
       class GoogleCloudRecommendationengineV1beta1UserEventImportSummary
         include Google::Apis::Core::Hashable
       
@@ -1768,8 +1654,8 @@ module Google
         # @return [Fixnum]
         attr_accessor :joined_events_count
       
-        # Count of user events imported, but with catalog information not found
-        # in the imported catalog.
+        # Count of user events imported, but with catalog information not found in the
+        # imported catalog.
         # Corresponds to the JSON property `unjoinedEventsCount`
         # @return [Fixnum]
         attr_accessor :unjoined_events_count
@@ -1808,30 +1694,28 @@ module Google
       class GoogleCloudRecommendationengineV1beta1UserInfo
         include Google::Apis::Core::Hashable
       
-        # Optional. Indicates if the request is made directly from the end user
-        # in which case the user_agent and ip_address fields can be populated
-        # from the HTTP request. This should *not* be set when using the javascript
-        # pixel. This flag should be set only if the API request is made directly
-        # from the end user such as a mobile app (and not if a gateway or a server is
-        # processing and pushing the user events).
+        # Optional. Indicates if the request is made directly from the end user in which
+        # case the user_agent and ip_address fields can be populated from the HTTP
+        # request. This should *not* be set when using the javascript pixel. This flag
+        # should be set only if the API request is made directly from the end user such
+        # as a mobile app (and not if a gateway or a server is processing and pushing
+        # the user events).
         # Corresponds to the JSON property `directUserRequest`
         # @return [Boolean]
         attr_accessor :direct_user_request
         alias_method :direct_user_request?, :direct_user_request
       
         # Optional. IP address of the user. This could be either IPv4 (e.g. 104.133.9.80)
-        # or
-        # IPv6 (e.g. 2001:0db8:85a3:0000:0000:8a2e:0370:7334). This should *not* be
-        # set when using the javascript pixel or if `direct_user_request` is set.
-        # Used to extract location information for personalization.
+        # or IPv6 (e.g. 2001:0db8:85a3:0000:0000:8a2e:0370:7334). This should *not* be
+        # set when using the javascript pixel or if `direct_user_request` is set. Used
+        # to extract location information for personalization.
         # Corresponds to the JSON property `ipAddress`
         # @return [String]
         attr_accessor :ip_address
       
-        # Optional. User agent as included in the HTTP header. UTF-8 encoded string
-        # with a length limit of 1 KiB.
-        # This should *not* be set when using the JavaScript pixel or if
-        # `directUserRequest` is set.
+        # Optional. User agent as included in the HTTP header. UTF-8 encoded string with
+        # a length limit of 1 KiB. This should *not* be set when using the JavaScript
+        # pixel or if `directUserRequest` is set.
         # Corresponds to the JSON property `userAgent`
         # @return [String]
         attr_accessor :user_agent
@@ -1842,12 +1726,11 @@ module Google
         # @return [String]
         attr_accessor :user_id
       
-        # Required. A unique identifier for tracking visitors with a length limit of
-        # 128 bytes.
-        # For example, this could be implemented with a http cookie, which should be
-        # able to uniquely identify a visitor on a single device. This unique
-        # identifier should not change if the visitor log in/out of the website.
-        # Maximum length 128 bytes. Cannot be empty.
+        # Required. A unique identifier for tracking visitors with a length limit of 128
+        # bytes. For example, this could be implemented with a http cookie, which should
+        # be able to uniquely identify a visitor on a single device. This unique
+        # identifier should not change if the visitor log in/out of the website. Maximum
+        # length 128 bytes. Cannot be empty.
         # Corresponds to the JSON property `visitorId`
         # @return [String]
         attr_accessor :visitor_id
@@ -1896,47 +1779,45 @@ module Google
       class GoogleLongrunningOperation
         include Google::Apis::Core::Hashable
       
-        # If the value is `false`, it means the operation is still in progress.
-        # If `true`, the operation is completed, and either `error` or `response` is
-        # available.
+        # If the value is `false`, it means the operation is still in progress. If `true`
+        # , the operation is completed, and either `error` or `response` is available.
         # Corresponds to the JSON property `done`
         # @return [Boolean]
         attr_accessor :done
         alias_method :done?, :done
       
-        # The `Status` type defines a logical error model that is suitable for
-        # different programming environments, including REST APIs and RPC APIs. It is
-        # used by [gRPC](https://github.com/grpc). Each `Status` message contains
-        # three pieces of data: error code, error message, and error details.
-        # You can find out more about this error model and how to work with it in the
-        # [API Design Guide](https://cloud.google.com/apis/design/errors).
+        # The `Status` type defines a logical error model that is suitable for different
+        # programming environments, including REST APIs and RPC APIs. It is used by [
+        # gRPC](https://github.com/grpc). Each `Status` message contains three pieces of
+        # data: error code, error message, and error details. You can find out more
+        # about this error model and how to work with it in the [API Design Guide](https:
+        # //cloud.google.com/apis/design/errors).
         # Corresponds to the JSON property `error`
         # @return [Google::Apis::RecommendationengineV1beta1::GoogleRpcStatus]
         attr_accessor :error
       
-        # Service-specific metadata associated with the operation.  It typically
-        # contains progress information and common metadata such as create time.
-        # Some services might not provide such metadata.  Any method that returns a
-        # long-running operation should document the metadata type, if any.
+        # Service-specific metadata associated with the operation. It typically contains
+        # progress information and common metadata such as create time. Some services
+        # might not provide such metadata. Any method that returns a long-running
+        # operation should document the metadata type, if any.
         # Corresponds to the JSON property `metadata`
         # @return [Hash<String,Object>]
         attr_accessor :metadata
       
         # The server-assigned name, which is only unique within the same service that
-        # originally returns it. If you use the default HTTP mapping, the
-        # `name` should be a resource name ending with `operations/`unique_id``.
+        # originally returns it. If you use the default HTTP mapping, the `name` should
+        # be a resource name ending with `operations/`unique_id``.
         # Corresponds to the JSON property `name`
         # @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 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`.
         # Corresponds to the JSON property `response`
         # @return [Hash<String,Object>]
         attr_accessor :response
@@ -1955,13 +1836,11 @@ module Google
         end
       end
       
-      # A generic empty message that you can re-use to avoid defining duplicated
-      # empty messages in your APIs. A typical example is to use it as the request
-      # or the response type of an API method. For instance:
-      # service Foo `
-      # rpc Bar(google.protobuf.Empty) returns (google.protobuf.Empty);
-      # `
-      # The JSON representation for `Empty` is empty JSON object ````.
+      # A generic empty message that you can re-use to avoid defining duplicated empty
+      # messages in your APIs. A typical example is to use it as the request or the
+      # response type of an API method. For instance: service Foo ` rpc Bar(google.
+      # protobuf.Empty) returns (google.protobuf.Empty); ` The JSON representation for
+      # `Empty` is empty JSON object ````.
       class GoogleProtobufEmpty
         include Google::Apis::Core::Hashable
       
@@ -1974,12 +1853,12 @@ module Google
         end
       end
       
-      # The `Status` type defines a logical error model that is suitable for
-      # different programming environments, including REST APIs and RPC APIs. It is
-      # used by [gRPC](https://github.com/grpc). Each `Status` message contains
-      # three pieces of data: error code, error message, and error details.
-      # You can find out more about this error model and how to work with it in the
-      # [API Design Guide](https://cloud.google.com/apis/design/errors).
+      # The `Status` type defines a logical error model that is suitable for different
+      # programming environments, including REST APIs and RPC APIs. It is used by [
+      # gRPC](https://github.com/grpc). Each `Status` message contains three pieces of
+      # data: error code, error message, and error details. You can find out more
+      # about this error model and how to work with it in the [API Design Guide](https:
+      # //cloud.google.com/apis/design/errors).
       class GoogleRpcStatus
         include Google::Apis::Core::Hashable
       
@@ -1988,15 +1867,15 @@ module Google
         # @return [Fixnum]
         attr_accessor :code
       
-        # A list of messages that carry the error details.  There is a common set of
+        # A list of messages that carry the error details. There is a common set of
         # message types for APIs to use.
         # Corresponds to the JSON property `details`
         # @return [Array<Hash<String,Object>>]
         attr_accessor :details
       
-        # A developer-facing error message, which should be in English. Any
-        # user-facing error message should be localized and sent in the
-        # google.rpc.Status.details field, or localized by the client.
+        # A developer-facing error message, which should be in English. Any user-facing
+        # error message should be localized and sent in the google.rpc.Status.details
+        # field, or localized by the client.
         # Corresponds to the JSON property `message`
         # @return [String]
         attr_accessor :message