docs: [google-cloud-eventarc-publishing] Documentation improvements for the Publisher service (#13613)

gcf-owl-bot[bot] · web-flow · commit 4a1f53417b48 · 2025-03-06T20:01:53.000+05:00
- [ ] Regenerate this pull request now. PiperOrigin-RevId: 733511393 Source-Link: googleapis/googleapis@526dfad Source-Link: googleapis/googleapis-gen@0330c0d Copy-Tag: eyJwIjoicGFja2FnZXMvZ29vZ2xlLWNsb3VkLWV2ZW50YXJjLXB1Ymxpc2hpbmcvLk93bEJvdC55YW1sIiwiaCI6IjAzMzBjMGQyY2I3NGFlNDQ4N2RiYjBiNjkwNzcyYTIzYjQ2MWU1NjUifQ== --------- Co-authored-by: Owl Bot <gcf-owl-bot[bot]@users.noreply.github.com>
diff --git a/packages/google-cloud-eventarc-publishing/google/cloud/eventarc_publishing_v1/services/publisher/async_client.py b/packages/google-cloud-eventarc-publishing/google/cloud/eventarc_publishing_v1/services/publisher/async_client.py
@@ -75,16 +75,22 @@ class PublisherAsyncClient:
     A subscriber is a GCP customer interested in receiving events.
 
     Channel is a first-class Eventarc resource that is created and
-    managed by the subscriber in their GCP project. A Channel
-    represents a subscriber's intent to receive events from an event
-    provider. A Channel is associated with exactly one event
-    provider.
+    managed by the subscriber in their Google Cloud project. A
+    Channel represents a subscriber's intent to receive events from
+    an event provider. A Channel is associated with exactly one
+    event provider.
 
     ChannelConnection is a first-class Eventarc resource that is
-    created and managed by the partner in their GCP project. A
-    ChannelConnection represents a connection between a partner and
-    a subscriber's Channel. A ChannelConnection has a one-to-one
-    mapping with a Channel.
+    created and managed by the partner in their Google Cloud
+    project. A ChannelConnection represents a connection between a
+    partner and a subscriber's Channel. A ChannelConnection has a
+    one-to-one mapping with a Channel.
+
+    Bus is a first-class Eventarc resource that is created and
+    managed in a Google Cloud project. A Bus provides a discoverable
+    endpoint for events and is a router that receives all events
+    published by event providers and delivers them to zero or more
+    subscribers.
 
     Publisher allows an event provider to publish events to
     Eventarc.
diff --git a/packages/google-cloud-eventarc-publishing/google/cloud/eventarc_publishing_v1/services/publisher/client.py b/packages/google-cloud-eventarc-publishing/google/cloud/eventarc_publishing_v1/services/publisher/client.py
@@ -119,16 +119,22 @@ class PublisherClient(metaclass=PublisherClientMeta):
     A subscriber is a GCP customer interested in receiving events.
 
     Channel is a first-class Eventarc resource that is created and
-    managed by the subscriber in their GCP project. A Channel
-    represents a subscriber's intent to receive events from an event
-    provider. A Channel is associated with exactly one event
-    provider.
+    managed by the subscriber in their Google Cloud project. A
+    Channel represents a subscriber's intent to receive events from
+    an event provider. A Channel is associated with exactly one
+    event provider.
 
     ChannelConnection is a first-class Eventarc resource that is
-    created and managed by the partner in their GCP project. A
-    ChannelConnection represents a connection between a partner and
-    a subscriber's Channel. A ChannelConnection has a one-to-one
-    mapping with a Channel.
+    created and managed by the partner in their Google Cloud
+    project. A ChannelConnection represents a connection between a
+    partner and a subscriber's Channel. A ChannelConnection has a
+    one-to-one mapping with a Channel.
+
+    Bus is a first-class Eventarc resource that is created and
+    managed in a Google Cloud project. A Bus provides a discoverable
+    endpoint for events and is a router that receives all events
+    published by event providers and delivers them to zero or more
+    subscribers.
 
     Publisher allows an event provider to publish events to
     Eventarc.
diff --git a/packages/google-cloud-eventarc-publishing/google/cloud/eventarc_publishing_v1/services/publisher/transports/grpc.py b/packages/google-cloud-eventarc-publishing/google/cloud/eventarc_publishing_v1/services/publisher/transports/grpc.py
@@ -126,16 +126,22 @@ class PublisherGrpcTransport(PublisherTransport):
     A subscriber is a GCP customer interested in receiving events.
 
     Channel is a first-class Eventarc resource that is created and
-    managed by the subscriber in their GCP project. A Channel
-    represents a subscriber's intent to receive events from an event
-    provider. A Channel is associated with exactly one event
-    provider.
+    managed by the subscriber in their Google Cloud project. A
+    Channel represents a subscriber's intent to receive events from
+    an event provider. A Channel is associated with exactly one
+    event provider.
 
     ChannelConnection is a first-class Eventarc resource that is
-    created and managed by the partner in their GCP project. A
-    ChannelConnection represents a connection between a partner and
-    a subscriber's Channel. A ChannelConnection has a one-to-one
-    mapping with a Channel.
+    created and managed by the partner in their Google Cloud
+    project. A ChannelConnection represents a connection between a
+    partner and a subscriber's Channel. A ChannelConnection has a
+    one-to-one mapping with a Channel.
+
+    Bus is a first-class Eventarc resource that is created and
+    managed in a Google Cloud project. A Bus provides a discoverable
+    endpoint for events and is a router that receives all events
+    published by event providers and delivers them to zero or more
+    subscribers.
 
     Publisher allows an event provider to publish events to
     Eventarc.
diff --git a/packages/google-cloud-eventarc-publishing/google/cloud/eventarc_publishing_v1/services/publisher/transports/grpc_asyncio.py b/packages/google-cloud-eventarc-publishing/google/cloud/eventarc_publishing_v1/services/publisher/transports/grpc_asyncio.py
@@ -131,16 +131,22 @@ class PublisherGrpcAsyncIOTransport(PublisherTransport):
     A subscriber is a GCP customer interested in receiving events.
 
     Channel is a first-class Eventarc resource that is created and
-    managed by the subscriber in their GCP project. A Channel
-    represents a subscriber's intent to receive events from an event
-    provider. A Channel is associated with exactly one event
-    provider.
+    managed by the subscriber in their Google Cloud project. A
+    Channel represents a subscriber's intent to receive events from
+    an event provider. A Channel is associated with exactly one
+    event provider.
 
     ChannelConnection is a first-class Eventarc resource that is
-    created and managed by the partner in their GCP project. A
-    ChannelConnection represents a connection between a partner and
-    a subscriber's Channel. A ChannelConnection has a one-to-one
-    mapping with a Channel.
+    created and managed by the partner in their Google Cloud
+    project. A ChannelConnection represents a connection between a
+    partner and a subscriber's Channel. A ChannelConnection has a
+    one-to-one mapping with a Channel.
+
+    Bus is a first-class Eventarc resource that is created and
+    managed in a Google Cloud project. A Bus provides a discoverable
+    endpoint for events and is a router that receives all events
+    published by event providers and delivers them to zero or more
+    subscribers.
 
     Publisher allows an event provider to publish events to
     Eventarc.
diff --git a/packages/google-cloud-eventarc-publishing/google/cloud/eventarc_publishing_v1/services/publisher/transports/rest.py b/packages/google-cloud-eventarc-publishing/google/cloud/eventarc_publishing_v1/services/publisher/transports/rest.py
@@ -270,16 +270,22 @@ class PublisherRestTransport(_BasePublisherRestTransport):
     A subscriber is a GCP customer interested in receiving events.
 
     Channel is a first-class Eventarc resource that is created and
-    managed by the subscriber in their GCP project. A Channel
-    represents a subscriber's intent to receive events from an event
-    provider. A Channel is associated with exactly one event
-    provider.
+    managed by the subscriber in their Google Cloud project. A
+    Channel represents a subscriber's intent to receive events from
+    an event provider. A Channel is associated with exactly one
+    event provider.
 
     ChannelConnection is a first-class Eventarc resource that is
-    created and managed by the partner in their GCP project. A
-    ChannelConnection represents a connection between a partner and
-    a subscriber's Channel. A ChannelConnection has a one-to-one
-    mapping with a Channel.
+    created and managed by the partner in their Google Cloud
+    project. A ChannelConnection represents a connection between a
+    partner and a subscriber's Channel. A ChannelConnection has a
+    one-to-one mapping with a Channel.
+
+    Bus is a first-class Eventarc resource that is created and
+    managed in a Google Cloud project. A Bus provides a discoverable
+    endpoint for events and is a router that receives all events
+    published by event providers and delivers them to zero or more
+    subscribers.
 
     Publisher allows an event provider to publish events to
     Eventarc.
