docs: modified some descriptions

Google APIs · copybara-github · commit c1f013491bc8 · 2023-10-16T14:51:02.000-07:00
PiperOrigin-RevId: 573936401
diff --git a/google/pubsub/v1/pubsub.proto b/google/pubsub/v1/pubsub.proto
@@ -44,7 +44,7 @@ service Publisher {
       "https://www.googleapis.com/auth/pubsub";
 
   // 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).
   rpc CreateTopic(Topic) returns (Topic) {
     option (google.api.http) = {
       put: "/v1/{name=projects/*/topics/*}"
@@ -137,11 +137,12 @@ service Publisher {
 
 // A policy constraining the storage of messages published to the topic.
 message MessageStoragePolicy {
-  // 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.
   repeated string allowed_persistence_regions = 1;
 }
 
@@ -430,16 +431,16 @@ service Subscriber {
       "https://www.googleapis.com/auth/pubsub";
 
   // Creates a subscription to a given topic. See the [resource name rules]
-  // (https://cloud.google.com/pubsub/docs/admin#resource_names).
+  // (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.
   rpc CreateSubscription(Subscription) returns (Subscription) {
     option (google.api.http) = {
       put: "/v1/{name=projects/*/subscriptions/*}"
@@ -592,7 +593,7 @@ service Subscriber {
   // 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
+  // (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.
   rpc CreateSnapshot(CreateSnapshotRequest) returns (Snapshot) {
@@ -1429,8 +1430,8 @@ message CreateSnapshotRequest {
   // in the request, the server will assign a 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). Format
-  // is `projects/{project}/snapshots/{snap}`.
+  // rules](https://cloud.google.com/pubsub/docs/pubsub-basics#resource_names).
+  // Format is `projects/{project}/snapshots/{snap}`.
   string name = 1 [
     (google.api.field_behavior) = REQUIRED,
     (google.api.resource_reference) = { type: "pubsub.googleapis.com/Snapshot" }
