feat: update public API to include annotation support (#381)

* feat: update public API to include annotation support

PiperOrigin-RevId: 496410329

Source-Link: googleapis/googleapis@cc3837a

Source-Link: https://github.com/googleapis/googleapis-gen/commit/fc0d1d212432583a11cd56c3b5c3e06252caf4ec
Copy-Tag: eyJwIjoiLmdpdGh1Yi8uT3dsQm90LnlhbWwiLCJoIjoiZmMwZDFkMjEyNDMyNTgzYTExY2Q1NmMzYjVjM2UwNjI1MmNhZjRlYyJ9

* 🦉 Updates from OwlBot post-processor

See https://github.com/googleapis/repo-automation-bots/blob/main/packages/owl-bot/README.md

Co-authored-by: Owl Bot <gcf-owl-bot[bot]@users.noreply.github.com>

Author: gcf-owl-bot[bot]

google/cloud/secretmanager_v1/services/secret_manager_service/async_client.py

@@ -432,8 +432,8 @@ async def sample_create_secret():
 
         Returns:
             google.cloud.secretmanager_v1.types.Secret:
-                A [Secret][google.cloud.secretmanager.v1.Secret] is a logical secret whose value and versions can
-                   be accessed.
+                A [Secret][google.cloud.secretmanager.v1.Secret] is a logical secret whose
+                   value and versions can be accessed.
 
                    A [Secret][google.cloud.secretmanager.v1.Secret] is
                    made up of zero or more
@@ -663,8 +663,8 @@ async def sample_get_secret():
 
         Returns:
             google.cloud.secretmanager_v1.types.Secret:
-                A [Secret][google.cloud.secretmanager.v1.Secret] is a logical secret whose value and versions can
-                   be accessed.
+                A [Secret][google.cloud.secretmanager.v1.Secret] is a logical secret whose
+                   value and versions can be accessed.
 
                    A [Secret][google.cloud.secretmanager.v1.Secret] is
                    made up of zero or more
@@ -778,8 +778,8 @@ async def sample_update_secret():
 
         Returns:
             google.cloud.secretmanager_v1.types.Secret:
-                A [Secret][google.cloud.secretmanager.v1.Secret] is a logical secret whose value and versions can
-                   be accessed.
+                A [Secret][google.cloud.secretmanager.v1.Secret] is a logical secret whose
+                   value and versions can be accessed.
 
                    A [Secret][google.cloud.secretmanager.v1.Secret] is
                    made up of zero or more

google/cloud/secretmanager_v1/services/secret_manager_service/client.py

@@ -686,8 +686,8 @@ def sample_create_secret():
 
         Returns:
             google.cloud.secretmanager_v1.types.Secret:
-                A [Secret][google.cloud.secretmanager.v1.Secret] is a logical secret whose value and versions can
-                   be accessed.
+                A [Secret][google.cloud.secretmanager.v1.Secret] is a logical secret whose
+                   value and versions can be accessed.
 
                    A [Secret][google.cloud.secretmanager.v1.Secret] is
                    made up of zero or more
@@ -917,8 +917,8 @@ def sample_get_secret():
 
         Returns:
             google.cloud.secretmanager_v1.types.Secret:
-                A [Secret][google.cloud.secretmanager.v1.Secret] is a logical secret whose value and versions can
-                   be accessed.
+                A [Secret][google.cloud.secretmanager.v1.Secret] is a logical secret whose
+                   value and versions can be accessed.
 
                    A [Secret][google.cloud.secretmanager.v1.Secret] is
                    made up of zero or more
@@ -1032,8 +1032,8 @@ def sample_update_secret():
 
         Returns:
             google.cloud.secretmanager_v1.types.Secret:
-                A [Secret][google.cloud.secretmanager.v1.Secret] is a logical secret whose value and versions can
-                   be accessed.
+                A [Secret][google.cloud.secretmanager.v1.Secret] is a logical secret whose
+                   value and versions can be accessed.
 
                    A [Secret][google.cloud.secretmanager.v1.Secret] is
                    made up of zero or more

google/cloud/secretmanager_v1/types/resources.py

@@ -118,6 +118,21 @@ class Secret(proto.Message):
             modifiable via UpdateSecret. At launch access by alias will
             only be supported on GetSecretVersion and
             AccessSecretVersion.
+        annotations (MutableMapping[str, str]):
+            Optional. Custom metadata about the secret.
+
+            Annotations are distinct from various forms of labels.
+            Annotations exist to allow client tools to store their own
+            state information without requiring a database.
+
+            Annotation keys must be between 1 and 63 characters long,
+            have a UTF-8 encoding of maximum 128 bytes, begin and end
+            with an alphanumeric character ([a-z0-9A-Z]), and may have
+            dashes (-), underscores (_), dots (.), and alphanumerics in
+            between these symbols.
+
+            The total size of annotation keys and values must be less
+            than 16KiB.
     """
 
     name: str = proto.Field(
@@ -170,6 +185,11 @@ class Secret(proto.Message):
         proto.INT64,
         number=11,
     )
+    annotations: MutableMapping[str, str] = proto.MapField(
+        proto.STRING,
+        proto.STRING,
+        number=13,
+    )
 
 
 class SecretVersion(proto.Message):

samples/generated_samples/snippet_metadata_google.cloud.secretmanager.v1.json

@@ -8,7 +8,7 @@
     ],
     "language": "PYTHON",
     "name": "google-cloud-secret-manager",
-    "version": "2.13.0"
+    "version": "0.1.0"
   },
   "snippets": [
     {