google-cloud-discovery_engine-v1beta 0.1.0 → 0.2.1

data/proto_docs/google/cloud/discoveryengine/v1beta/import_config.rb

@@ -236,6 +236,60 @@ module Google
         #     The mode of reconciliation between existing documents and the documents to
         #     be imported. Defaults to
         #     {::Google::Cloud::DiscoveryEngine::V1beta::ImportDocumentsRequest::ReconciliationMode::INCREMENTAL ReconciliationMode.INCREMENTAL}.
+        # @!attribute [rw] auto_generate_ids
+        #   @return [::Boolean]
+        #     Whether to automatically generate IDs for the documents if absent.
+        #
+        #     If set to `true`,
+        #     {::Google::Cloud::DiscoveryEngine::V1beta::Document#id Document.id}s are
+        #     automatically generated based on the hash of the payload, where IDs may not
+        #     be consistent during multiple imports. In which case
+        #     {::Google::Cloud::DiscoveryEngine::V1beta::ImportDocumentsRequest::ReconciliationMode::FULL ReconciliationMode.FULL}
+        #     is highly recommended to avoid duplicate contents. If unset or set to
+        #     `false`, {::Google::Cloud::DiscoveryEngine::V1beta::Document#id Document.id}s
+        #     have to be specified using
+        #     {::Google::Cloud::DiscoveryEngine::V1beta::ImportDocumentsRequest#id_field id_field},
+        #     otherwises, documents without IDs will fail to be imported.
+        #
+        #     Only set this field when using
+        #     {::Google::Cloud::DiscoveryEngine::V1beta::GcsSource GcsSource} or
+        #     {::Google::Cloud::DiscoveryEngine::V1beta::BigQuerySource BigQuerySource}, and
+        #     when
+        #     {::Google::Cloud::DiscoveryEngine::V1beta::GcsSource#data_schema GcsSource.data_schema}
+        #     or
+        #     {::Google::Cloud::DiscoveryEngine::V1beta::BigQuerySource#data_schema BigQuerySource.data_schema}
+        #     is `custom`. Otherwise, an INVALID_ARGUMENT error is thrown.
+        # @!attribute [rw] id_field
+        #   @return [::String]
+        #     The field in the Cloud Storage and BigQuery sources that indicates the
+        #     unique IDs of the documents.
+        #
+        #     For {::Google::Cloud::DiscoveryEngine::V1beta::GcsSource GcsSource} it is the
+        #     key of the JSON field. For instance, `my_id` for JSON `{"my_id":
+        #     "some_uuid"}`. For
+        #     {::Google::Cloud::DiscoveryEngine::V1beta::BigQuerySource BigQuerySource} it is
+        #     the column name of the BigQuery table where the unique ids are stored.
+        #
+        #     The values of the JSON field or the BigQuery column will be used as the
+        #     {::Google::Cloud::DiscoveryEngine::V1beta::Document#id Document.id}s. The JSON
+        #     field or the BigQuery column must be of string type, and the values must be
+        #     set as valid strings conform to
+        #     [RFC-1034](https://tools.ietf.org/html/rfc1034) with 1-63 characters.
+        #     Otherwise, documents without valid IDs will fail to be imported.
+        #
+        #     Only set this field when using
+        #     {::Google::Cloud::DiscoveryEngine::V1beta::GcsSource GcsSource} or
+        #     {::Google::Cloud::DiscoveryEngine::V1beta::BigQuerySource BigQuerySource}, and
+        #     when
+        #     {::Google::Cloud::DiscoveryEngine::V1beta::GcsSource#data_schema GcsSource.data_schema}
+        #     or
+        #     {::Google::Cloud::DiscoveryEngine::V1beta::BigQuerySource#data_schema BigQuerySource.data_schema}
+        #     is `custom`. And only set this field when
+        #     {::Google::Cloud::DiscoveryEngine::V1beta::ImportDocumentsRequest#auto_generate_ids auto_generate_ids}
+        #     is unset or set as `false`. Otherwise, an INVALID_ARGUMENT error is thrown.
+        #
+        #     If it is unset, a default value `_id` is used when importing from the
+        #     allowed data sources.
         class ImportDocumentsRequest
           include ::Google::Protobuf::MessageExts
           extend ::Google::Protobuf::MessageExts::ClassMethods

data/proto_docs/google/cloud/discoveryengine/v1beta/search_service.rb

@@ -100,9 +100,7 @@ module Google
         #   @return [::Google::Protobuf::Map{::String => ::Google::Protobuf::Value}]
         #     Additional search parameters.
         #
-        #     For
-        #     [IndustryVertical.SITE_SEARCH][google.cloud.discoveryengine.v1beta.IndustryVertical.SITE_SEARCH]
-        #     vertical, supported values are:
+        #     For public website search only, supported values are:
         #
         #     * `user_country_code`: string. Default empty. If set to non-empty, results
         #        are restricted or boosted based on the location provided.

data/proto_docs/google/protobuf/any.rb

@@ -43,8 +43,12 @@ module Google
     #     if (any.is(Foo.class)) {
     #       foo = any.unpack(Foo.class);
     #     }
+    #     // or ...
+    #     if (any.isSameTypeAs(Foo.getDefaultInstance())) {
+    #       foo = any.unpack(Foo.getDefaultInstance());
+    #     }
     #
-    # Example 3: Pack and unpack a message in Python.
+    #  Example 3: Pack and unpack a message in Python.
     #
     #     foo = Foo(...)
     #     any = Any()
@@ -54,7 +58,7 @@ module Google
     #       any.Unpack(foo)
     #       ...
     #
-    # Example 4: Pack and unpack a message in Go
+    #  Example 4: Pack and unpack a message in Go
     #
     #      foo := &pb.Foo{...}
     #      any, err := anypb.New(foo)
@@ -73,9 +77,8 @@ module Google
     # in the type URL, for example "foo.bar.com/x/y.z" will yield type
     # name "y.z".
     #
-    #
     # JSON
-    #
+    # ====
     # The JSON representation of an `Any` value uses the regular
     # representation of the deserialized, embedded message, with an
     # additional field `@type` which contains the type URL. Example:

data/proto_docs/google/protobuf/struct.rb

@@ -87,7 +87,7 @@ module Google
     # `NullValue` is a singleton enumeration to represent the null value for the
     # `Value` type union.
     #
-    #  The JSON representation for `NullValue` is JSON `null`.
+    # The JSON representation for `NullValue` is JSON `null`.
     module NullValue
       # Null value.
       NULL_VALUE = 0

data/proto_docs/google/protobuf/timestamp.rb

@@ -69,7 +69,6 @@ module Google
     #     Timestamp timestamp = Timestamp.newBuilder().setSeconds(millis / 1000)
     #         .setNanos((int) ((millis % 1000) * 1000000)).build();
     #
-    #
     # Example 5: Compute Timestamp from Java `Instant.now()`.
     #
     #     Instant now = Instant.now();
@@ -78,7 +77,6 @@ module Google
     #         Timestamp.newBuilder().setSeconds(now.getEpochSecond())
     #             .setNanos(now.getNano()).build();
     #
-    #
     # Example 6: Compute Timestamp from current time in Python.
     #
     #     timestamp = Timestamp()
@@ -108,7 +106,7 @@ module Google
     # [`strftime`](https://docs.python.org/2/library/time.html#time.strftime) with
     # the time format spec '%Y-%m-%dT%H:%M:%S.%fZ'. Likewise, in Java, one can use
     # the Joda Time's [`ISODateTimeFormat.dateTime()`](
-    # http://www.joda.org/joda-time/apidocs/org/joda/time/format/ISODateTimeFormat.html#dateTime%2D%2D
+    # http://joda-time.sourceforge.net/apidocs/org/joda/time/format/ISODateTimeFormat.html#dateTime()
     # ) to obtain a formatter capable of generating timestamps in this format.
     # @!attribute [rw] seconds
     #   @return [::Integer]

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: google-cloud-discovery_engine-v1beta
 version: !ruby/object:Gem::Version
-  version: 0.1.0
+  version: 0.2.1
 platform: ruby
 authors:
 - Google LLC
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2023-05-24 00:00:00.000000000 Z
+date: 2023-06-06 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: gapic-common
@@ -16,7 +16,7 @@ dependencies:
     requirements:
     - - ">="
       - !ruby/object:Gem::Version
-        version: 0.18.0
+        version: 0.19.1
     - - "<"
       - !ruby/object:Gem::Version
         version: 2.a
@@ -26,7 +26,7 @@ dependencies:
     requirements:
     - - ">="
       - !ruby/object:Gem::Version
-        version: 0.18.0
+        version: 0.19.1
     - - "<"
       - !ruby/object:Gem::Version
         version: 2.a