@google-cloud/discoveryengine 0.8.0 → 1.0.0

package/build/protos/google/cloud/discoveryengine/v1beta/search_service.proto

@@ -56,6 +56,15 @@ service SearchService {
 // [SearchService.Search][google.cloud.discoveryengine.v1beta.SearchService.Search]
 // method.
 message SearchRequest {
+  // Specifies the image query input.
+  message ImageQuery {
+    oneof image {
+      // Base64 encoded image bytes. Supported image formats: JPEG, PNG, and
+      // BMP.
+      string image_bytes = 1;
+    }
+  }
+
   // A facet specification to perform faceted search.
   message FacetSpec {
     // Specifies how a facet is computed.
@@ -65,7 +74,7 @@ message SearchRequest {
       // which the facet values are computed. Facet key is case-sensitive.
       string key = 1 [(google.api.field_behavior) = REQUIRED];
 
-      // Set only if values should be bucketized into intervals. Must be set
+      // Set only if values should be bucketed into intervals. Must be set
       // for facets with numerical values. Must not be set for facet with text
       // values. Maximum number of intervals is 30.
       repeated Interval intervals = 2;
@@ -73,22 +82,22 @@ message SearchRequest {
       // Only get facet for the given restricted values. Only supported on
       // textual fields. For example, suppose "category" has three values
       // "Action > 2022", "Action > 2021" and "Sci-Fi > 2022". If set
-      // "restricted_values" to "Action > 2022", the "category" facet will only
-      // contain "Action > 2022". Only supported on textual fields. Maximum
+      // "restricted_values" to "Action > 2022", the "category" facet only
+      // contains "Action > 2022". Only supported on textual fields. Maximum
       // is 10.
       repeated string restricted_values = 3;
 
       // Only get facet values that start with the given string prefix. For
       // example, suppose "category" has three values "Action > 2022",
       // "Action > 2021" and "Sci-Fi > 2022". If set "prefixes" to "Action", the
-      // "category" facet will only contain "Action > 2022" and "Action > 2021".
+      // "category" facet only contains "Action > 2022" and "Action > 2021".
       // Only supported on textual fields. Maximum is 10.
       repeated string prefixes = 4;
 
       // Only get facet values that contains the given strings. For example,
       // suppose "category" has three values "Action > 2022",
       // "Action > 2021" and "Sci-Fi > 2022". If set "contains" to "2022", the
-      // "category" facet will only contain "Action > 2022" and "Sci-Fi > 2022".
+      // "category" facet only contains "Action > 2022" and "Sci-Fi > 2022".
       // Only supported on textual fields. Maximum is 10.
       repeated string contains = 5;
 
@@ -121,7 +130,7 @@ message SearchRequest {
 
     // Maximum of facet values that should be returned for this facet. If
     // unspecified, defaults to 20. The maximum allowed value is 300. Values
-    // above 300 will be coerced to 300.
+    // above 300 are coerced to 300.
     //
     // If this field is negative, an  `INVALID_ARGUMENT`  is returned.
     int32 limit = 2;
@@ -158,15 +167,15 @@ message SearchRequest {
 
     // Enables dynamic position for this facet. If set to true, the position of
     // this facet among all facets in the response is determined automatically.
-    // It will be ordered together with dynamic facets if dynamic
-    // facets is enabled. If set to false, the position of this facet in the
-    // response will be the same as in the request, and it will be ranked before
+    // If dynamic facets are enabled, it is ordered together.
+    // If set to false, the position of this facet in the
+    // response is the same as in the request, and it is ranked before
     // the facets with dynamic position enable and all dynamic facets.
     //
     // For example, you may always want to have rating facet returned in
     // the response, but it's not necessarily to always display the rating facet
     // at the top. In that case, you can set enable_dynamic_position to true so
-    // that the position of rating facet in response will be determined
+    // that the position of rating facet in response is determined
     // automatically.
     //
     // Another example, assuming you have the following facets in the request:
@@ -177,13 +186,13 @@ message SearchRequest {
     //
     // * "brands", enable_dynamic_position = false
     //
-    // And also you have a dynamic facets enable, which will generate a facet
-    // 'gender'. Then the final order of the facets in the response can be
+    // And also you have a dynamic facets enabled, which generates a facet
+    // `gender`. Then the final order of the facets in the response can be
     // ("price", "brands", "rating", "gender") or ("price", "brands", "gender",
     // "rating") depends on how API orders "gender" and "rating" facets.
-    // However, notice that "price" and "brands" will always be
-    // ranked at 1st and 2nd position since their enable_dynamic_position are
-    // false.
+    // However, notice that "price" and "brands" are always
+    // ranked at first and second position because their enable_dynamic_position
+    // is false.
     bool enable_dynamic_position = 4;
   }
 
@@ -281,72 +290,126 @@ message SearchRequest {
     Mode mode = 1;
   }
 
-  // The specification that configs the desired behavior of the UCS content
-  // search.
+  // A specification for configuring the behavior of content search.
   message ContentSearchSpec {
-    // The specification that configs the snippet in the search results.
+    // A specification for configuring snippets in a search response.
     message SnippetSpec {
-      // Max number of snippets returned in each search result.
-      //
-      // A snippet is an infomartive summary of a content with highlighting for
-      // UI rendering.
-      //
-      // If the matching snippets is less than the max_snippet_count, return all
-      // of the snippets; otherwise, return the max_snippet_count.
-      //
-      // At most 5 snippets will be returned for each SearchResult.
-      int32 max_snippet_count = 1;
-
-      // if true, only snippet reference is returned.
-      bool reference_only = 2;
+      // [DEPRECATED] This field is deprecated. To control snippet return, use
+      // `return_snippet` field. For backwards compatibility, we will return
+      // snippet if max_snippet_count > 0.
+      int32 max_snippet_count = 1 [deprecated = true];
+
+      // [DEPRECATED] This field is deprecated and will have no affect on the
+      // snippet.
+      bool reference_only = 2 [deprecated = true];
+
+      // If `true`, then return snippet. If no snippet can be generated, we
+      // return "No snippet is available for this page." A `snippet_status` with
+      // `SUCCESS` or `NO_SNIPPET_AVAILABLE` will also be returned.
+      bool return_snippet = 3;
     }
 
-    // The specification that configs the summary in the search response.
+    // A specification for configuring a summary returned in a search
+    // response.
     message SummarySpec {
-      // The number of top results the summary should be generated from.
-      // If the number of returned results is less than summary_result_count,
-      // then the summary would be derived from all the results; otherwise, the
-      // summary would be derived from the top results.
+      // The number of top results to generate the summary from. If the number
+      // of results returned is less than `summaryResultCount`, the summary is
+      // generated from all of the results.
       //
-      // At most 5 results can be used for generating summary.
+      // At most five results can be used to generate a summary.
       int32 summary_result_count = 1;
+
+      // Specifies whether to include citations in the summary. The default
+      // value is `false`.
+      //
+      // When this field is set to `true`, summaries include in-line citation
+      // numbers.
+      //
+      // Example summary including citations:
+      //
+      // BigQuery is Google Cloud's fully managed and completely serverless
+      // enterprise data warehouse [1]. BigQuery supports all data types, works
+      // across clouds, and has built-in machine learning and business
+      // intelligence, all within a unified platform [2, 3].
+      //
+      // The citation numbers refer to the returned search results and are
+      // 1-indexed. For example, [1] means that the sentence is attributed to
+      // the first search result. [2, 3] means that the sentence is attributed
+      // to both the second and third search results.
+      bool include_citations = 2;
+
+      // Specifies whether to filter out adversarial queries. The default value
+      // is `false`.
+      //
+      // Google employs search-query classification to detect adversarial
+      // queries. No summary is returned if the search query is classified as an
+      // adversarial query. For example, a user might ask a question regarding
+      // negative comments about the company or submit a query designed to
+      // generate unsafe, policy-violating output. If this field is set to
+      // `true`, we skip generating summaries for adversarial queries and return
+      // fallback messages instead.
+      bool ignore_adversarial_query = 3;
+
+      // Specifies whether to filter out queries that are not summary-seeking.
+      // The default value is `false`.
+      //
+      // Google employs search-query classification to detect summary-seeking
+      // queries. No summary is returned if the search query is classified as a
+      // non-summary seeking query. For example, `why is the sky blue` and `Who
+      // is the best soccer player in the world?` are summary-seeking queries,
+      // but `SFO airport` and `world cup 2026` are not. They are most likely
+      // navigational queries. If this field is set to `true`, we skip
+      // generating summaries for non-summary seeking queries and return
+      // fallback messages instead.
+      bool ignore_non_summary_seeking_query = 4;
     }
 
-    // The specification that configs the extractive content in search results.
+    // A specification for configuring the extractive content in a search
+    // response.
     message ExtractiveContentSpec {
-      // The max number of extractive answers returned in each search result.
+      // The maximum number of extractive answers returned in each search
+      // result.
       //
       // An extractive answer is a verbatim answer extracted from the original
-      // document, which provides precise and contextually relevant answer to
+      // document, which provides a precise and contextually relevant answer to
       // the search query.
       //
       // If the number of matching answers is less than the
-      // extractive_answer_count, return all of the answers; otherwise, return
-      // the extractive_answer_count.
+      // `max_extractive_answer_count`, return all of the answers. Otherwise,
+      // return the `max_extractive_answer_count`.
       //
-      // At most 5 answers will be returned for each SearchResult.
+      // At most one answer is returned for each
+      // [SearchResult][google.cloud.discoveryengine.v1beta.SearchResponse.SearchResult].
       int32 max_extractive_answer_count = 1;
 
       // The max number of extractive segments returned in each search result.
+      // Only applied if the
+      // [DataStore][google.cloud.discoveryengine.v1beta.DataStore] is set to
+      // [DataStore.ContentConfig.CONTENT_REQUIRED][google.cloud.discoveryengine.v1beta.DataStore.ContentConfig.CONTENT_REQUIRED]
+      // or
+      // [DataStore.solution_types][google.cloud.discoveryengine.v1beta.DataStore.solution_types]
+      // is
+      // [SOLUTION_TYPE_CHAT][google.cloud.discoveryengine.v1beta.SolutionType.SOLUTION_TYPE_CHAT].
       //
       // An extractive segment is a text segment extracted from the original
-      // document which is relevant to the search query and in general more
-      // verbose than an extrative answer. The segment could then be used as
+      // document that is relevant to the search query, and, in general, more
+      // verbose than an extractive answer. The segment could then be used as
       // input for LLMs to generate summaries and answers.
       //
-      // If the number of matching segments is less than the
-      // max_extractive_segment_count, return all of the segments; otherwise,
-      // return the max_extractive_segment_count.
+      // If the number of matching segments is less than
+      // `max_extractive_segment_count`, return all of the segments. Otherwise,
+      // return the `max_extractive_segment_count`.
       //
-      // Currently one segment will be returned for each SearchResult.
+      // Currently one segment is returned for each
+      // [SearchResult][google.cloud.discoveryengine.v1beta.SearchResponse.SearchResult].
       int32 max_extractive_segment_count = 2;
     }
 
-    // If there is no snippet spec provided, there will be no snippet in the
-    // search result.
+    // If `snippetSpec` is not specified, snippets are not included in the
+    // search response.
     SnippetSpec snippet_spec = 1;
 
-    // If there is no summary spec provided, there will be no summary in the
+    // If `summarySpec` is not specified, summaries are not included in the
     // search response.
     SummarySpec summary_spec = 2;
 
@@ -378,9 +441,12 @@ message SearchRequest {
   // Raw search query.
   string query = 3;
 
+  // Raw image query.
+  ImageQuery image_query = 19;
+
   // Maximum number of [Document][google.cloud.discoveryengine.v1beta.Document]s
   // to return. If unspecified, defaults to a reasonable value. The maximum
-  // allowed value is 100. Values above 100 will be coerced to 100.
+  // allowed value is 100. Values above 100 are coerced to 100.
   //
   // If this field is negative, an  `INVALID_ARGUMENT`  is returned.
   int32 page_size = 4;
@@ -412,17 +478,18 @@ message SearchRequest {
   // If this field is unrecognizable, an  `INVALID_ARGUMENT`  is returned.
   string filter = 7;
 
-  // The order in which documents are returned. Document can be ordered by
+  // The order in which documents are returned. Documents can be ordered by
   // a field in an [Document][google.cloud.discoveryengine.v1beta.Document]
-  // object. Leave it unset if ordered by relevance. OrderBy expression is
+  // object. Leave it unset if ordered by relevance. `order_by` expression is
   // case-sensitive.
   //
-  // If this field is unrecognizable, an  `INVALID_ARGUMENT`  is returned.
+  // If this field is unrecognizable, an `INVALID_ARGUMENT` is returned.
   string order_by = 8;
 
   // Information about the end user.
-  // Highly recommended for analytics. The user_agent string in UserInfo will
-  // be used to deduce device_type for analytics.
+  // Highly recommended for analytics.
+  // [UserInfo.user_agent][google.cloud.discoveryengine.v1beta.UserInfo.user_agent]
+  // is used to deduce `device_type` for analytics.
   UserInfo user_info = 21;
 
   // Facet specifications for faceted search. If empty, no facets are returned.
@@ -446,11 +513,11 @@ message SearchRequest {
   map<string, google.protobuf.Value> params = 11;
 
   // The query expansion specification that specifies the conditions under which
-  // query expansion will occur.
+  // query expansion occurs.
   QueryExpansionSpec query_expansion_spec = 13;
 
   // The spell correction specification that specifies the mode under
-  // which spell correction will take effect.
+  // which spell correction takes effect.
   SpellCorrectionSpec spell_correction_spec = 14;
 
   // A unique identifier for tracking visitors. For example, this could be
@@ -469,12 +536,11 @@ message SearchRequest {
   // characters. Otherwise, an  `INVALID_ARGUMENT`  error is returned.
   string user_pseudo_id = 15;
 
-  // The content search spec that configs the desired behavior of content
-  // search.
+  // A specification for configuring the behavior of content search.
   ContentSearchSpec content_search_spec = 24;
 
   // Whether to turn on safe search. This is only supported for
-  // [ContentConfig.PUBLIC_WEBSITE][].
+  // website search.
   bool safe_search = 20;
 
   // The user labels applied to a resource must meet the following requirements:
@@ -556,12 +622,46 @@ message SearchResponse {
 
     // A list of ranked refinement attributes.
     repeated RefinementAttribute refinement_attributes = 1;
+
+    // Suggested follow-up questions.
+    repeated string follow_up_questions = 2;
   }
 
   // Summary of the top N search result specified by the summary spec.
   message Summary {
+    // An Enum for summary-skipped reasons.
+    enum SummarySkippedReason {
+      // Default value. The summary skipped reason is not specified.
+      SUMMARY_SKIPPED_REASON_UNSPECIFIED = 0;
+
+      // The adversarial query ignored case.
+      //
+      // Only populated when
+      // [SummarySpec.ignore_adversarial_query][google.cloud.discoveryengine.v1beta.SearchRequest.ContentSearchSpec.SummarySpec.ignore_adversarial_query]
+      // is set to `true`.
+      ADVERSARIAL_QUERY_IGNORED = 1;
+
+      // The non-summary seeking query ignored case.
+      //
+      // Only populated when
+      // [SummarySpec.ignore_non_summary_seeking_query][google.cloud.discoveryengine.v1beta.SearchRequest.ContentSearchSpec.SummarySpec.ignore_non_summary_seeking_query]
+      // is set to `true`.
+      NON_SUMMARY_SEEKING_QUERY_IGNORED = 2;
+
+      // The out-of-domain query ignored case.
+      //
+      // Google skips the summary if there are no high-relevance search results.
+      // For example, the data store contains facts about company A but the
+      // user query is asking questions about company B.
+      OUT_OF_DOMAIN_QUERY_IGNORED = 3;
+    }
+
     // The summary content.
     string summary_text = 1;
+
+    // Additional summary-skipped reasons. This provides the reason for ignored
+    // cases. If nothing is skipped, this field is not set.
+    repeated SummarySkippedReason summary_skipped_reasons = 2;
   }
 
   // A list of matched documents. The order represents the ranking.

package/build/protos/google/cloud/discoveryengine/v1beta/user_event.proto

@@ -66,7 +66,7 @@ message UserEvent {
   // quality.
   //
   // The field must be a UTF-8 encoded string with a length limit of 128
-  // characters. Otherwise, an INVALID_ARGUMENT error is returned.
+  // characters. Otherwise, an `INVALID_ARGUMENT` error is returned.
   //
   // The field should not contain PII or user-data. We recommend to use Google
   // Analytics [Client
@@ -120,20 +120,20 @@ message UserEvent {
   //
   // The value must be one of:
   //
-  // * [PredictResponse.attribution_token][] for events that are the result of
+  // * [RecommendResponse.attribution_token][google.cloud.discoveryengine.v1beta.RecommendResponse.attribution_token] for events that are the result of
   // [RecommendationService.Recommend][google.cloud.discoveryengine.v1beta.RecommendationService.Recommend].
   // * [SearchResponse.attribution_token][google.cloud.discoveryengine.v1beta.SearchResponse.attribution_token] for events that are the result of
   // [SearchService.Search][google.cloud.discoveryengine.v1beta.SearchService.Search].
-  // * [CompleteQueryResponse.attribution_token][] for events that are the
-  // result of
-  // [CompletionService.CompleteQuery][google.cloud.discoveryengine.v1beta.CompletionService.CompleteQuery].
   //
   // This token enables us to accurately attribute page view or conversion
   // completion back to the event and the particular predict response containing
   // this clicked/purchased product. If user clicks on product K in the
-  // recommendation results, pass [PredictResponse.attribution_token][] as a URL
-  // parameter to product K's page. When recording events on product K's page,
-  // log the [PredictResponse.attribution_token][] to this field.
+  // recommendation results, pass
+  // [RecommendResponse.attribution_token][google.cloud.discoveryengine.v1beta.RecommendResponse.attribution_token]
+  // as a URL parameter to product K's page. When recording events on product
+  // K's page, log the
+  // [RecommendResponse.attribution_token][google.cloud.discoveryengine.v1beta.RecommendResponse.attribution_token]
+  // to this field.
   string attribution_token = 8;
 
   // The filter syntax consists of an expression language for constructing a
@@ -151,10 +151,11 @@ message UserEvent {
   // to https://google.aip.dev/160#filtering.
   //
   // The value must be a UTF-8 encoded string with a length limit of 1,000
-  // characters. Otherwise, an INVALID_ARGUMENT error is returned.
+  // characters. Otherwise, an `INVALID_ARGUMENT` error is returned.
   string filter = 9;
 
-  // List of Documents associated with this user event.
+  // List of [Document][google.cloud.discoveryengine.v1beta.Document]s
+  // associated with this user event.
   //
   // This field is optional except for the following event types:
   //
@@ -176,12 +177,14 @@ message UserEvent {
   // Panel metadata associated with this user event.
   PanelInfo panel = 11;
 
-  // Search API details related to the event.
+  // [SearchService.Search][google.cloud.discoveryengine.v1beta.SearchService.Search]
+  // details related to the event.
   //
   // This field should be set for `search` event.
   SearchInfo search_info = 12;
 
-  // CompleteQuery API details related to the event.
+  // [CompletionService.CompleteQuery][google.cloud.discoveryengine.v1beta.CompletionService.CompleteQuery]
+  // details related to the event.
   //
   // This field should be set for `search` event when autocomplete function is
   // enabled and the user clicks a suggestion for search.
@@ -221,7 +224,7 @@ message UserEvent {
   // * For number attributes, at most 400 values are allowed.
   //
   // For product recommendations, an example of extra user information is
-  // ` traffic_channel`, which is how a user arrives at the site. Users can
+  // `traffic_channel`, which is how a user arrives at the site. Users can
   // arrive
   // at the site by coming to the site directly, coming through Google
   // search, or in other ways.
@@ -237,7 +240,7 @@ message PageInfo {
   //
   // 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
+  // events as the user is browsing the page. The `pageview_id` property should
   // be kept the same for all these events so that they can be grouped together
   // properly.
   //
@@ -253,10 +256,10 @@ message PageInfo {
   //
   // Category pages include special pages such as sales or promotions. For
   // instance, a special sale page may have the category hierarchy:
-  // "pageCategory" : "Sales > 2017 Black Friday Deals".
+  // `"pageCategory" : "Sales > 2017 Black Friday Deals"`.
   //
   // Required for `view-category-page` events. Other event types should not set
-  // this field. Otherwise, an INVALID_ARGUMENT error is returned.
+  // this field. Otherwise, an `INVALID_ARGUMENT` error is returned.
   string page_category = 2;
 
   // Complete URL (window.location.href) of the user's current page.
@@ -283,14 +286,14 @@ message SearchInfo {
   // for definition.
   //
   // The value must be a UTF-8 encoded string with a length limit of 5,000
-  // characters. Otherwise, an INVALID_ARGUMENT error is returned.
+  // characters. Otherwise, an `INVALID_ARGUMENT` error is returned.
   //
   // At least one of
   // [search_query][google.cloud.discoveryengine.v1beta.SearchInfo.search_query]
   // or
   // [PageInfo.page_category][google.cloud.discoveryengine.v1beta.PageInfo.page_category]
   // is required for `search` events. Other event types should not set this
-  // field. Otherwise, an INVALID_ARGUMENT error is returned.
+  // field. Otherwise, an `INVALID_ARGUMENT` error is returned.
   string search_query = 1;
 
   // The order in which products are returned, if applicable.
@@ -300,10 +303,10 @@ message SearchInfo {
   // for definition and syntax.
   //
   // The value must be a UTF-8 encoded string with a length limit of 1,000
-  // characters. Otherwise, an INVALID_ARGUMENT error is returned.
+  // characters. Otherwise, an `INVALID_ARGUMENT` error is returned.
   //
   // This can only be set for `search` events. Other event types should not set
-  // this field. Otherwise, an INVALID_ARGUMENT error is returned.
+  // this field. Otherwise, an `INVALID_ARGUMENT` error is returned.
   string order_by = 2;
 
   // An integer that specifies the current offset for pagination (the 0-indexed
@@ -313,20 +316,22 @@ message SearchInfo {
   // [SearchRequest.offset][google.cloud.discoveryengine.v1beta.SearchRequest.offset]
   // for definition.
   //
-  // If this field is negative, an INVALID_ARGUMENT is returned.
+  // If this field is negative, an `INVALID_ARGUMENT` is returned.
   //
   // This can only be set for `search` events. Other event types should not set
-  // this field. Otherwise, an INVALID_ARGUMENT error is returned.
+  // this field. Otherwise, an `INVALID_ARGUMENT` error is returned.
   optional int32 offset = 3;
 }
 
 // Detailed completion information including completion attribution token and
 // clicked completion info.
 message CompletionInfo {
-  // End user selected [CompleteQueryResponse.CompletionResult.suggestion][].
+  // End user selected
+  // [CompleteQueryResponse.QuerySuggestion.suggestion][google.cloud.discoveryengine.v1beta.CompleteQueryResponse.QuerySuggestion.suggestion].
   string selected_suggestion = 1;
 
-  // End user selected [CompleteQueryResponse.CompletionResult.suggestion][]
+  // End user selected
+  // [CompleteQueryResponse.QuerySuggestion.suggestion][google.cloud.discoveryengine.v1beta.CompleteQueryResponse.QuerySuggestion.suggestion]
   // position, starting from 0.
   int32 selected_position = 2;
 }
@@ -396,17 +401,15 @@ message DocumentInfo {
   // `{location}`, `{collection_id}`, `{data_store_id}`, and
   // `{branch_id}` are used when annotating with the stored Document.
   oneof document_descriptor {
-    // Required. The Document resource ID.
-    string id = 1 [(google.api.field_behavior) = REQUIRED];
+    // The [Document][google.cloud.discoveryengine.v1beta.Document] resource ID.
+    string id = 1;
 
-    // Required. The Document resource full name, of the form:
+    // The [Document][google.cloud.discoveryengine.v1beta.Document] resource
+    // full name, of the form:
     // `projects/{project_id}/locations/{location}/collections/{collection_id}/dataStores/{data_store_id}/branches/{branch_id}/documents/{document_id}`
-    string name = 2 [
-      (google.api.field_behavior) = REQUIRED,
-      (google.api.resource_reference) = {
-        type: "discoveryengine.googleapis.com/Document"
-      }
-    ];
+    string name = 2 [(google.api.resource_reference) = {
+      type: "discoveryengine.googleapis.com/Document"
+    }];
   }
 
   // Quantity of the Document associated with the user event. Defaults to 1.
@@ -450,11 +453,13 @@ message PanelInfo {
 message MediaInfo {
   // The media progress time in seconds, if applicable.
   // For example, if the end user has finished 90 seconds of a playback video,
-  // then [MediaInfo.media_progress_duration.seconds][Duration.seconds] should
-  // be set to 90.
+  // then
+  // [MediaInfo.media_progress_duration.seconds][google.protobuf.Duration.seconds]
+  // should be set to 90.
   google.protobuf.Duration media_progress_duration = 1;
 
-  // Media progress should be computed using only the media_progress_duration
+  // Media progress should be computed using only the
+  // [media_progress_duration][google.cloud.discoveryengine.v1beta.MediaInfo.media_progress_duration]
   // relative to the media total length.
   //
   // This value must be between `[0, 1.0]` inclusive.

package/build/protos/google/cloud/discoveryengine/v1beta/user_event_service.proto

@@ -53,7 +53,7 @@ service UserEventService {
   }
 
   // Writes a single user event from the browser. This uses a GET request to
-  // due to browser restriction of POST-ing to a 3rd party domain.
+  // due to browser restriction of POST-ing to a third-party domain.
   //
   // This method is used only by the Discovery Engine API JavaScript pixel and
   // Google Tag Manager. Users should not call this method directly.
@@ -122,7 +122,7 @@ message CollectUserEventRequest {
 
   // The URL including cgi-parameters but excluding the hash fragment with a
   // length limit of 5,000 characters. This is often more useful than the
-  // referer URL, because many browsers only send the domain for 3rd party
+  // referer URL, because many browsers only send the domain for third-party
   // requests.
   optional string uri = 3;