Topic pub-sub

Pub/Sub

Pub/Sub Product Playbook

Section 1

Pub/Sub Product Playbook

Pub/Sub

Product Baseline — standalone product knowledge block. This file contains the product knowledge needed to study this product independently.

Learning Map

By the end of this chapter, you should be able to reason about:

  • Topics, subscriptions, publishers and subscribers
  • Push vs pull delivery
  • At-least-once delivery, acknowledgement and redelivery
  • Ordering, replay/retention and dead-letter handling
  • Fan-out and independent consumer semantics
  • Throughput, backpressure and subscriber scaling
  • Security and private connectivity
  • Pub/Sub vs Kafka-compatible messaging

Official Learning Resources

Section 2

Product Identity

Product Identity

  • Plain-language purpose: Global real-time messaging.

  • Catalogue category: Analytics

  • Catalogue summary: Global real-time messaging

  • Known aliases: Pub/Sub, Cloud Pub/Sub

Need to Know

Pub/Sub — managed asynchronous event ingestion and delivery. A topic represents the published stream; a subscription owns independent delivery state for a consumer workload.

When to Choose

Choose Pub/Sub when producers and consumers need to be decoupled, events arrive continuously, or multiple independent consumers need the same event stream.

Common Patterns

PatternProduct guidance
Event ingestion and bufferingUse Pub/Sub to accept and buffer asynchronous events between producers and consumers.
Decoupled consumersGive independent logical consumers separate subscriptions when each consumer must receive every event.
Shared worker poolMultiple workers processing one logical workload can consume from the same subscription.
Streaming pipeline chainA common architecture is Pub/Sub for transport, Dataflow for transformation, and BigQuery for analytical storage.
Incompatible consumer rolloutUse an independent subscription for a new incompatible consumer or pipeline so old and new versions do not compete for the same delivery state.

Boundary: Pub/Sub transports and buffers events; it is not the transformation engine or analytical database.

Section 3

Terminology for Reasoning

Terminology for Reasoning

Start with the product’s own vocabulary. The third column turns each term into a reasoning cue rather than a definition to memorize.

Product termMeaningWhy it matters when reasoning
TopicNamed resource to which publishers send messages.Represents the producer-facing event channel; consumers do not normally compete directly on the topic.
SubscriptionNamed delivery resource attached to a topic.Each subscription has independent delivery state, so separate logical consumers usually need separate subscriptions.
PublisherProducer that sends messages to a topic.Publisher independence is part of Pub/Sub’s asynchronous decoupling model.
SubscriberConsumer that receives messages through a subscription.Scale and delivery behavior are reasoned about at the subscription/subscriber side.
AcknowledgmentSubscriber signal that processing of a delivered message succeeded.Failure to acknowledge can cause redelivery; processing must account for delivery semantics.
Ack deadlineTime allowed before an unacknowledged message becomes eligible for redelivery.Too-short deadlines can create avoidable redelivery; extending them is not a substitute for healthy consumers.
Dead-letter topicTopic used for messages that cannot be processed successfully after configured delivery attempts.Provides an isolation/recovery path for poison messages rather than infinite normal-path retries.
Ordering keyMessage attribute used to request ordered delivery for related messages.Choose ordering only where per-key order is a real requirement because it constrains delivery behavior.

Cross-product reasoning vocabulary

Reasoning termMeaning
PurposeThe primary problem the product exists to solve.
Workload shapeThe characteristic form of the work, such as batch, streaming, transactional, analytical, orchestration, messaging, or storage.
Architectural layerWhere the product acts in the system, such as ingestion, transport, processing, storage, serving, orchestration, governance, security, or operations.
Operational modelWhat Google manages and what the customer still configures, secures, monitors, and operates.
Decision boundaryThe requirement that makes this product a better or worse fit than an adjacent product.
Anti-patternA requirement or design choice that conflicts with the product’s purpose or operating model.

Use the product terms first, then use the cross-product vocabulary to explain why those concepts change an architectural decision.

Section 4

Knowledge Check

Knowledge Check

QuestionResolution guidance
What primary workload is Pub/Sub designed to solve?Resolve: Pub/Sub is primarily for global real-time messaging. Then classify that purpose by workload shape and architectural layer, and explain why that makes the service a fit. Do not stop at a feature list.
When is Pub/Sub the wrong choice?Use the anti-patterns and decision boundaries. Name cases where another product better matches the workload, access pattern, compatibility, failure domain, or operational-control requirement.
What adjacent products are most easily confused with it?State the decisive boundary as: Choose X when …; choose Y when …. Prefer workload and constraint reasoning over feature lists.
What operational responsibilities remain with the customer?Separate what Google manages from what the customer must still design, configure, secure, monitor, test, or operate.
What reliability, security, performance, and cost factors matter most?Explain the important failure boundaries, controls, performance levers, and cost drivers, including why each design choice changes the outcome.
How would you recognize Pub/Sub without seeing the product name?Recognize the workload, hard constraints, architectural layer, compatibility requirements, and operational model—the problem signature that points toward Pub/Sub.
Section 5

Conclusion

Conclusion

  • Start with the workload: understand the problem Pub/Sub is designed to solve before memorizing features.
  • Use constraints to decide: access pattern, compatibility, failure domain, operational ownership, security, performance, and cost should drive the choice.
  • Know the boundaries: explain when an adjacent product is a better fit and why.
  • Reason about operations: distinguish managed capabilities from customer responsibilities.
  • Recognize the problem signature: identify Pub/Sub from architectural requirements even when its name is absent.
  • Revisit weak areas: use the Learning Map and Knowledge Check to decide what to review next.
Section 6

Maintenance Notes

Maintenance Notes

Prefer durable product facts and product-level decision boundaries. Verify volatile runtime, version, quota, pricing, and availability details against official product documentation before updating this material.