diff --git a/google/cloud/recommender_v1/services/recommender/async_client.py b/google/cloud/recommender_v1/services/recommender/async_client.py
index bdb77f5..2302ff9 100644
--- a/google/cloud/recommender_v1/services/recommender/async_client.py
+++ b/google/cloud/recommender_v1/services/recommender/async_client.py
@@ -181,6 +181,8 @@ async def list_insights(
 
                 LOCATION here refers to GCP Locations:
                 https://cloud.google.com/about/locations/
+                INSIGHT_TYPE_ID refers to supported insight types:
+                https://cloud.google.com/recommender/docs/insights/insight-types.)
                 This corresponds to the ``parent`` field
                 on the ``request`` instance; if ``request`` is provided, this
                 should not be set.
@@ -459,7 +461,9 @@ async def list_recommendations(
                 "projects/[PROJECT_NUMBER]/locations/[LOCATION]/recommenders/[RECOMMENDER_ID]",
 
                 LOCATION here refers to GCP Locations:
-                https://cloud.google.com/about/locations/
+                https://cloud.google.com/about/locations/ RECOMMENDER_ID
+                refers to supported recommenders:
+                https://cloud.google.com/recommender/docs/recommenders.
                 This corresponds to the ``parent`` field
                 on the ``request`` instance; if ``request`` is provided, this
                 should not be set.
diff --git a/google/cloud/recommender_v1/services/recommender/client.py b/google/cloud/recommender_v1/services/recommender/client.py
index fb75aa8..7139bd5 100644
--- a/google/cloud/recommender_v1/services/recommender/client.py
+++ b/google/cloud/recommender_v1/services/recommender/client.py
@@ -424,6 +424,8 @@ def list_insights(
 
                 LOCATION here refers to GCP Locations:
                 https://cloud.google.com/about/locations/
+                INSIGHT_TYPE_ID refers to supported insight types:
+                https://cloud.google.com/recommender/docs/insights/insight-types.)
                 This corresponds to the ``parent`` field
                 on the ``request`` instance; if ``request`` is provided, this
                 should not be set.
@@ -689,7 +691,9 @@ def list_recommendations(
                 "projects/[PROJECT_NUMBER]/locations/[LOCATION]/recommenders/[RECOMMENDER_ID]",
 
                 LOCATION here refers to GCP Locations:
-                https://cloud.google.com/about/locations/
+                https://cloud.google.com/about/locations/ RECOMMENDER_ID
+                refers to supported recommenders:
+                https://cloud.google.com/recommender/docs/recommenders.
                 This corresponds to the ``parent`` field
                 on the ``request`` instance; if ``request`` is provided, this
                 should not be set.
diff --git a/google/cloud/recommender_v1/types/recommendation.py b/google/cloud/recommender_v1/types/recommendation.py
index 7becf01..e1c4de9 100644
--- a/google/cloud/recommender_v1/types/recommendation.py
+++ b/google/cloud/recommender_v1/types/recommendation.py
@@ -217,11 +217,11 @@ class Operation(proto.Message):
 
             -  Example: ``{ "/versions/*/name" : "it-123"
                "/versions/*/targetSize/percent": 20 }``
-            -  Example: ``{ "/bindings/*/role": "roles/admin"
+            -  Example: ``{ "/bindings/*/role": "roles/owner"
                "/bindings/*/condition" : null }``
-            -  Example: ``{ "/bindings/*/role": "roles/admin"
-               "/bindings/*/members/*" : ["x@google.com",
-               "y@google.com"] }`` When both path_filters and
+            -  Example: ``{ "/bindings/*/role": "roles/owner"
+               "/bindings/*/members/*" : ["x@example.com",
+               "y@example.com"] }`` When both path_filters and
                path_value_matchers are set, an implicit AND must be
                performed.
         path_value_matchers (Sequence[~.recommendation.Operation.PathValueMatchersEntry]):
diff --git a/google/cloud/recommender_v1/types/recommender_service.py b/google/cloud/recommender_v1/types/recommender_service.py
index eaf488e..c366b02 100644
--- a/google/cloud/recommender_v1/types/recommender_service.py
+++ b/google/cloud/recommender_v1/types/recommender_service.py
@@ -52,7 +52,9 @@ class ListInsightsRequest(proto.Message):
             "projects/[PROJECT_NUMBER]/locations/[LOCATION]/insightTypes/[INSIGHT_TYPE_ID]",
 
             LOCATION here refers to GCP Locations:
-            https://cloud.google.com/about/locations/
+            https://cloud.google.com/about/locations/ INSIGHT_TYPE_ID
+            refers to supported insight types:
+            https://cloud.google.com/recommender/docs/insights/insight-types.)
         page_size (int):
             Optional. The maximum number of results to
             return from this request.  Non-positive values
@@ -145,7 +147,9 @@ class ListRecommendationsRequest(proto.Message):
             "projects/[PROJECT_NUMBER]/locations/[LOCATION]/recommenders/[RECOMMENDER_ID]",
 
             LOCATION here refers to GCP Locations:
-            https://cloud.google.com/about/locations/
+            https://cloud.google.com/about/locations/ RECOMMENDER_ID
+            refers to supported recommenders:
+            https://cloud.google.com/recommender/docs/recommenders.
         page_size (int):
             Optional. The maximum number of results to
             return from this request.  Non-positive values
diff --git a/google/cloud/recommender_v1beta1/services/recommender/async_client.py b/google/cloud/recommender_v1beta1/services/recommender/async_client.py
index 834ee51..6a93552 100644
--- a/google/cloud/recommender_v1beta1/services/recommender/async_client.py
+++ b/google/cloud/recommender_v1beta1/services/recommender/async_client.py
@@ -181,6 +181,8 @@ async def list_insights(
 
                 LOCATION here refers to GCP Locations:
                 https://cloud.google.com/about/locations/
+                INSIGHT_TYPE_ID refers to supported insight types:
+                https://cloud.google.com/recommender/docs/insights/insight-types.
                 This corresponds to the ``parent`` field
                 on the ``request`` instance; if ``request`` is provided, this
                 should not be set.
@@ -459,7 +461,9 @@ async def list_recommendations(
                 "projects/[PROJECT_NUMBER]/locations/[LOCATION]/recommenders/[RECOMMENDER_ID]",
 
                 LOCATION here refers to GCP Locations:
-                https://cloud.google.com/about/locations/
+                https://cloud.google.com/about/locations/ RECOMMENDER_ID
+                refers to supported recommenders:
+                https://cloud.google.com/recommender/docs/recommenders.
                 This corresponds to the ``parent`` field
                 on the ``request`` instance; if ``request`` is provided, this
                 should not be set.
diff --git a/google/cloud/recommender_v1beta1/services/recommender/client.py b/google/cloud/recommender_v1beta1/services/recommender/client.py
index 8534acb..e3ea7d3 100644
--- a/google/cloud/recommender_v1beta1/services/recommender/client.py
+++ b/google/cloud/recommender_v1beta1/services/recommender/client.py
@@ -424,6 +424,8 @@ def list_insights(
 
                 LOCATION here refers to GCP Locations:
                 https://cloud.google.com/about/locations/
+                INSIGHT_TYPE_ID refers to supported insight types:
+                https://cloud.google.com/recommender/docs/insights/insight-types.
                 This corresponds to the ``parent`` field
                 on the ``request`` instance; if ``request`` is provided, this
                 should not be set.
@@ -689,7 +691,9 @@ def list_recommendations(
                 "projects/[PROJECT_NUMBER]/locations/[LOCATION]/recommenders/[RECOMMENDER_ID]",
 
                 LOCATION here refers to GCP Locations:
-                https://cloud.google.com/about/locations/
+                https://cloud.google.com/about/locations/ RECOMMENDER_ID
+                refers to supported recommenders:
+                https://cloud.google.com/recommender/docs/recommenders.
                 This corresponds to the ``parent`` field
                 on the ``request`` instance; if ``request`` is provided, this
                 should not be set.
diff --git a/google/cloud/recommender_v1beta1/types/recommendation.py b/google/cloud/recommender_v1beta1/types/recommendation.py
index bcb9d6e..f05060f 100644
--- a/google/cloud/recommender_v1beta1/types/recommendation.py
+++ b/google/cloud/recommender_v1beta1/types/recommendation.py
@@ -217,11 +217,11 @@ class Operation(proto.Message):
 
             -  Example: ``{ "/versions/*/name" : "it-123"
                "/versions/*/targetSize/percent": 20 }``
-            -  Example: ``{ "/bindings/*/role": "roles/admin"
+            -  Example: ``{ "/bindings/*/role": "roles/owner"
                "/bindings/*/condition" : null }``
-            -  Example: ``{ "/bindings/*/role": "roles/admin"
-               "/bindings/*/members/*" : ["x@google.com",
-               "y@google.com"] }`` When both path_filters and
+            -  Example: ``{ "/bindings/*/role": "roles/owner"
+               "/bindings/*/members/*" : ["x@example.com",
+               "y@example.com"] }`` When both path_filters and
                path_value_matchers are set, an implicit AND must be
                performed.
         path_value_matchers (Sequence[~.recommendation.Operation.PathValueMatchersEntry]):
diff --git a/google/cloud/recommender_v1beta1/types/recommender_service.py b/google/cloud/recommender_v1beta1/types/recommender_service.py
index 11d2748..402b510 100644
--- a/google/cloud/recommender_v1beta1/types/recommender_service.py
+++ b/google/cloud/recommender_v1beta1/types/recommender_service.py
@@ -52,7 +52,9 @@ class ListInsightsRequest(proto.Message):
             "projects/[PROJECT_NUMBER]/locations/[LOCATION]/insightTypes/[INSIGHT_TYPE_ID]",
 
             LOCATION here refers to GCP Locations:
-            https://cloud.google.com/about/locations/
+            https://cloud.google.com/about/locations/ INSIGHT_TYPE_ID
+            refers to supported insight types:
+            https://cloud.google.com/recommender/docs/insights/insight-types.
         page_size (int):
             Optional. The maximum number of results to
             return from this request.  Non-positive values
@@ -145,7 +147,9 @@ class ListRecommendationsRequest(proto.Message):
             "projects/[PROJECT_NUMBER]/locations/[LOCATION]/recommenders/[RECOMMENDER_ID]",
 
             LOCATION here refers to GCP Locations:
-            https://cloud.google.com/about/locations/
+            https://cloud.google.com/about/locations/ RECOMMENDER_ID
+            refers to supported recommenders:
+            https://cloud.google.com/recommender/docs/recommenders.
         page_size (int):
             Optional. The maximum number of results to
             return from this request.  Non-positive values
diff --git a/synth.metadata b/synth.metadata
index 9b5960f..10fba5b 100644
--- a/synth.metadata
+++ b/synth.metadata
@@ -4,15 +4,15 @@
       "git": {
         "name": ".",
         "remote": "https://github.com/googleapis/python-recommender.git",
-        "sha": "5f3dbe447101439b6598e73794debdeb8941884c"
+        "sha": "10043cc32d9c13ab92da62e214a972918336e88d"
       }
     },
     {
       "git": {
         "name": "googleapis",
         "remote": "https://github.com/googleapis/googleapis.git",
-        "sha": "dd372aa22ded7a8ba6f0e03a80e06358a3fa0907",
-        "internalRef": "347055288"
+        "sha": "5256ab60f3d396a3d1bd393043776936b9651c5b",
+        "internalRef": "347703845"
       }
     },
     {