docs(talent): update docstring for DiversificationLevel (#9958)

googleapis · Dec 11, 2019 · 5cb6e71 · 5cb6e71
1 parent e801a86
commit 5cb6e71
Show file tree

Hide file tree

Showing 3 changed files with 11 additions and 5 deletions.
diff --git a/packages/google-cloud-talent/google/cloud/talent_v4beta1/gapic/enums.py b/packages/google-cloud-talent/google/cloud/talent_v4beta1/gapic/enums.py
@@ -1042,7 +1042,10 @@ class DiversificationLevel(enum.IntEnum):
           similar jobs appearing in sequence in the search results.
           SIMPLE (int): Default diversifying behavior. The result list is ordered so that
           highly similar results are pushed to the end of the last page of search
-          results.
+          results. If you are using pageToken to page through the result set,
+          latency might be lower but we can't guarantee that all results are
+          returned. If you are using page offset, latency might be higher but all
+          results are returned.
         """
 
         DIVERSIFICATION_LEVEL_UNSPECIFIED = 0

diff --git a/packages/google-cloud-talent/google/cloud/talent_v4beta1/proto/job_service.proto b/packages/google-cloud-talent/google/cloud/talent_v4beta1/proto/job_service.proto
@@ -471,7 +471,10 @@ message SearchJobsRequest {
 
     // Default diversifying behavior. The result list is ordered so that
     // highly similar results are pushed to the end of the last page of search
-    // results.
+    // results. If you are using pageToken to page through the result set,
+    // latency might be lower but we can't guarantee that all results are
+    // returned. If you are using page offset, latency might be higher but all
+    // results are returned.
     SIMPLE = 2;
   }
 

diff --git a/packages/google-cloud-talent/synth.metadata b/packages/google-cloud-talent/synth.metadata
@@ -1,5 +1,5 @@
 {
-  "updateTime": "2019-12-07T13:27:57.902246Z",
+  "updateTime": "2019-12-11T13:23:35.931326Z",
   "sources": [
     {
       "generator": {
@@ -12,8 +12,8 @@
       "git": {
         "name": "googleapis",
         "remote": "https://github.com/googleapis/googleapis.git",
-        "sha": "a4adac3a12aca6e3a792c9c35ee850435fe7cf7e",
-        "internalRef": "284277770"
+        "sha": "e47fdd266542386e5e7346697f90476e96dc7ee8",
+        "internalRef": "284822593"
       }
     },
     {