🦉 Updates from OwlBot post-processor

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

google/pubsub_v1/services/publisher/async_client.py

@@ -230,7 +230,7 @@ async def create_topic(
     ) -> pubsub.Topic:
         r"""Creates the given topic with the given name. See the [resource
         name rules]
-        (https://cloud.google.com/pubsub/docs/admin#resource_names).
+        (https://cloud.google.com/pubsub/docs/pubsub-basics#resource_names).
 
         .. code-block:: python
 

google/pubsub_v1/services/publisher/client.py

@@ -512,7 +512,7 @@ def create_topic(
     ) -> pubsub.Topic:
         r"""Creates the given topic with the given name. See the [resource
         name rules]
-        (https://cloud.google.com/pubsub/docs/admin#resource_names).
+        (https://cloud.google.com/pubsub/docs/pubsub-basics#resource_names).
 
         .. code-block:: python
 

google/pubsub_v1/services/publisher/transports/grpc.py

@@ -241,7 +241,7 @@ def create_topic(self) -> Callable[[pubsub.Topic], pubsub.Topic]:
 
         Creates the given topic with the given name. See the [resource
         name rules]
-        (https://cloud.google.com/pubsub/docs/admin#resource_names).
+        (https://cloud.google.com/pubsub/docs/pubsub-basics#resource_names).
 
         Returns:
             Callable[[~.Topic],

google/pubsub_v1/services/publisher/transports/grpc_asyncio.py

@@ -244,7 +244,7 @@ def create_topic(self) -> Callable[[pubsub.Topic], Awaitable[pubsub.Topic]]:
 
         Creates the given topic with the given name. See the [resource
         name rules]
-        (https://cloud.google.com/pubsub/docs/admin#resource_names).
+        (https://cloud.google.com/pubsub/docs/pubsub-basics#resource_names).
 
         Returns:
             Callable[[~.Topic],

google/pubsub_v1/services/subscriber/async_client.py

@@ -238,17 +238,17 @@ async def create_subscription(
     ) -> pubsub.Subscription:
         r"""Creates a subscription to a given topic. See the [resource name
         rules]
-        (https://cloud.google.com/pubsub/docs/admin#resource_names). If
-        the subscription already exists, returns ``ALREADY_EXISTS``. If
-        the corresponding topic doesn't exist, returns ``NOT_FOUND``.
+        (https://cloud.google.com/pubsub/docs/pubsub-basics#resource_names).
+        If the subscription already exists, returns ``ALREADY_EXISTS``.
+        If the corresponding topic doesn't exist, returns ``NOT_FOUND``.
 
         If the name is not provided in the request, the server will
         assign a random name for this subscription on the same project
         as the topic, conforming to the [resource name format]
-        (https://cloud.google.com/pubsub/docs/admin#resource_names). The
-        generated name is populated in the returned Subscription object.
-        Note that for REST API requests, you must specify a name in the
-        request.
+        (https://cloud.google.com/pubsub/docs/pubsub-basics#resource_names).
+        The generated name is populated in the returned Subscription
+        object. Note that for REST API requests, you must specify a name
+        in the request.
 
         .. code-block:: python
 
@@ -1804,8 +1804,8 @@ async def create_snapshot(
         the request, the server will assign a random name for this
         snapshot on the same project as the subscription, conforming to
         the [resource name format]
-        (https://cloud.google.com/pubsub/docs/admin#resource_names). The
-        generated name is populated in the returned Snapshot object.
+        (https://cloud.google.com/pubsub/docs/pubsub-basics#resource_names).
+        The generated name is populated in the returned Snapshot object.
         Note that for REST API requests, you must specify a name in the
         request.
 
@@ -1846,7 +1846,7 @@ async def sample_create_snapshot():
                 project as the subscription. Note that for REST API
                 requests, you must specify a name. See the `resource
                 name
-                rules <https://cloud.google.com/pubsub/docs/admin#resource_names>`__.
+                rules <https://cloud.google.com/pubsub/docs/pubsub-basics#resource_names>`__.
                 Format is ``projects/{project}/snapshots/{snap}``.
 
                 This corresponds to the ``name`` field

google/pubsub_v1/services/subscriber/client.py

@@ -519,17 +519,17 @@ def create_subscription(
     ) -> pubsub.Subscription:
         r"""Creates a subscription to a given topic. See the [resource name
         rules]
-        (https://cloud.google.com/pubsub/docs/admin#resource_names). If
-        the subscription already exists, returns ``ALREADY_EXISTS``. If
-        the corresponding topic doesn't exist, returns ``NOT_FOUND``.
+        (https://cloud.google.com/pubsub/docs/pubsub-basics#resource_names).
+        If the subscription already exists, returns ``ALREADY_EXISTS``.
+        If the corresponding topic doesn't exist, returns ``NOT_FOUND``.
 
         If the name is not provided in the request, the server will
         assign a random name for this subscription on the same project
         as the topic, conforming to the [resource name format]
-        (https://cloud.google.com/pubsub/docs/admin#resource_names). The
-        generated name is populated in the returned Subscription object.
-        Note that for REST API requests, you must specify a name in the
-        request.
+        (https://cloud.google.com/pubsub/docs/pubsub-basics#resource_names).
+        The generated name is populated in the returned Subscription
+        object. Note that for REST API requests, you must specify a name
+        in the request.
 
         .. code-block:: python
 
@@ -1961,8 +1961,8 @@ def create_snapshot(
         the request, the server will assign a random name for this
         snapshot on the same project as the subscription, conforming to
         the [resource name format]
-        (https://cloud.google.com/pubsub/docs/admin#resource_names). The
-        generated name is populated in the returned Snapshot object.
+        (https://cloud.google.com/pubsub/docs/pubsub-basics#resource_names).
+        The generated name is populated in the returned Snapshot object.
         Note that for REST API requests, you must specify a name in the
         request.
 
@@ -2003,7 +2003,7 @@ def sample_create_snapshot():
                 project as the subscription. Note that for REST API
                 requests, you must specify a name. See the `resource
                 name
-                rules <https://cloud.google.com/pubsub/docs/admin#resource_names>`__.
+                rules <https://cloud.google.com/pubsub/docs/pubsub-basics#resource_names>`__.
                 Format is ``projects/{project}/snapshots/{snap}``.
 
                 This corresponds to the ``name`` field

google/pubsub_v1/services/subscriber/transports/grpc.py

@@ -245,17 +245,17 @@ def create_subscription(
 
         Creates a subscription to a given topic. See the [resource name
         rules]
-        (https://cloud.google.com/pubsub/docs/admin#resource_names). If
-        the subscription already exists, returns ``ALREADY_EXISTS``. If
-        the corresponding topic doesn't exist, returns ``NOT_FOUND``.
+        (https://cloud.google.com/pubsub/docs/pubsub-basics#resource_names).
+        If the subscription already exists, returns ``ALREADY_EXISTS``.
+        If the corresponding topic doesn't exist, returns ``NOT_FOUND``.
 
         If the name is not provided in the request, the server will
         assign a random name for this subscription on the same project
         as the topic, conforming to the [resource name format]
-        (https://cloud.google.com/pubsub/docs/admin#resource_names). The
-        generated name is populated in the returned Subscription object.
-        Note that for REST API requests, you must specify a name in the
-        request.
+        (https://cloud.google.com/pubsub/docs/pubsub-basics#resource_names).
+        The generated name is populated in the returned Subscription
+        object. Note that for REST API requests, you must specify a name
+        in the request.
 
         Returns:
             Callable[[~.Subscription],
@@ -617,8 +617,8 @@ def create_snapshot(
         the request, the server will assign a random name for this
         snapshot on the same project as the subscription, conforming to
         the [resource name format]
-        (https://cloud.google.com/pubsub/docs/admin#resource_names). The
-        generated name is populated in the returned Snapshot object.
+        (https://cloud.google.com/pubsub/docs/pubsub-basics#resource_names).
+        The generated name is populated in the returned Snapshot object.
         Note that for REST API requests, you must specify a name in the
         request.
 

google/pubsub_v1/services/subscriber/transports/grpc_asyncio.py

@@ -248,17 +248,17 @@ def create_subscription(
 
         Creates a subscription to a given topic. See the [resource name
         rules]
-        (https://cloud.google.com/pubsub/docs/admin#resource_names). If
-        the subscription already exists, returns ``ALREADY_EXISTS``. If
-        the corresponding topic doesn't exist, returns ``NOT_FOUND``.
+        (https://cloud.google.com/pubsub/docs/pubsub-basics#resource_names).
+        If the subscription already exists, returns ``ALREADY_EXISTS``.
+        If the corresponding topic doesn't exist, returns ``NOT_FOUND``.
 
         If the name is not provided in the request, the server will
         assign a random name for this subscription on the same project
         as the topic, conforming to the [resource name format]
-        (https://cloud.google.com/pubsub/docs/admin#resource_names). The
-        generated name is populated in the returned Subscription object.
-        Note that for REST API requests, you must specify a name in the
-        request.
+        (https://cloud.google.com/pubsub/docs/pubsub-basics#resource_names).
+        The generated name is populated in the returned Subscription
+        object. Note that for REST API requests, you must specify a name
+        in the request.
 
         Returns:
             Callable[[~.Subscription],
@@ -630,8 +630,8 @@ def create_snapshot(
         the request, the server will assign a random name for this
         snapshot on the same project as the subscription, conforming to
         the [resource name format]
-        (https://cloud.google.com/pubsub/docs/admin#resource_names). The
-        generated name is populated in the returned Snapshot object.
+        (https://cloud.google.com/pubsub/docs/pubsub-basics#resource_names).
+        The generated name is populated in the returned Snapshot object.
         Note that for REST API requests, you must specify a name in the
         request.
 

google/pubsub_v1/types/pubsub.py

@@ -84,14 +84,15 @@ class MessageStoragePolicy(proto.Message):
 
     Attributes:
         allowed_persistence_regions (MutableSequence[str]):
-            A list of IDs of GCP regions where messages
-            that are published to the topic may be persisted
-            in storage. Messages published by publishers
-            running in non-allowed GCP regions (or running
-            outside of GCP altogether) will be routed for
-            storage in one of the allowed regions. An empty
-            list means that no regions are allowed, and is
-            not a valid configuration.
+            A list of IDs of Google Cloud regions where
+            messages that are published to the topic may be
+            persisted in storage. Messages published by
+            publishers running in non-allowed Google Cloud
+            regions (or running outside of Google Cloud
+            altogether) are routed for storage in one of the
+            allowed regions. An empty list means that no
+            regions are allowed, and is not a valid
+            configuration.
     """
 
     allowed_persistence_regions: MutableSequence[str] = proto.RepeatedField(
@@ -1885,7 +1886,7 @@ class CreateSnapshotRequest(proto.Message):
             random name for this snapshot on the same project as the
             subscription. Note that for REST API requests, you must
             specify a name. See the `resource name
-            rules <https://cloud.google.com/pubsub/docs/admin#resource_names>`__.
+            rules <https://cloud.google.com/pubsub/docs/pubsub-basics#resource_names>`__.
             Format is ``projects/{project}/snapshots/{snap}``.
         subscription (str):
             Required. The subscription whose backlog the snapshot