Configure Pub/Sub in Application Design Center

Stay organized with collections Save and categorize content based on your preferences.

Pub/Sub is an asynchronous and scalable messaging service that decouples services producing messages from services processing those messages.

For more information, see What is Pub/Sub?

This document describes the parameters you can configure when using App Design Center to create a Pub/Sub topic and subscription.

Required configuration parameters

If your template includes a Pub/Sub component, you must configure the following parameters before you deploy.

Parameter name	Description and constraints	Background information
The project where you want to deploy the Pub/Sub resource.	Configure components
Topic	name	Guidelines to name a topic, subscription, schema, or snapshot

Optional configuration parameters

The following parameters are optional. To display advanced parameters, in the Configuration area, select Show advanced fields.

Feature	Parameter name	Description and constraint information	Background information
	Create Topic	By default, a topic is created. Clear the checkbox if you don't want to create a topic.	Create a topic
	Create Subscriptions	By default, a subscription is created. Clear the checkbox if you don't want to create a subscription.	Subscription overview
Topic Labels	Key	labels	Reporting usage with labels
	Value	labels	Reporting usage with labels
Push Subscriptions	Name	name	Guidelines to name a topic, subscription, schema, or snapshot
	Ack Deadline Seconds	ackDeadlineSeconds	Acknowledgment deadline
	Push Endpoint	pushEndpoint	Endpoints
	X-goog-version	The Pub/Sub API format of the pushed message. For example, v1beta1.	attributes
	OIDC Service Account email	serviceAccountEmail	Authentication
	Audience	audience	Authentication
	Expiration Policy	expirationPolicy	Expiration period
	Dead Letter Topic	deadLetterTopic	Dead letter topic
	Retain Acked Messages	retainAckedMessages	Retain acknowledged messages
	Message Retention Duration	messageRetentionDuration	Message retention duration
	Max Delivery Attempts	maxDeliveryAttempts	Dead letter topic
	Maximum Backoff	maximumBackoff	Retry policy
	Minimum Backoff	minimumBackoff	Retry policy
	Filter	filter	Subscription filter
	Enable Message Ordering	enableMessageOrdering	Message ordering
Pull Subscriptions	Name	name	Guidelines to name a topic, subscription, schema, or snapshot
	Ack Deadline Seconds	ackDeadlineSeconds	Acknowledgment deadline
	Dead Letter Topic	deadLetterTopic	Dead letter topic
	Max Delivery Attempts	maxDeliveryAttempts	Dead letter topic
	Retain Acked Messages	retainAckedMessages	Retain acknowledged messages
	Message Retention Duration	messageRetentionDuration	Message retention duration
	Maximum Backoff	maximumBackoff	Retry policy
	Minimum Backoff	minimumBackoff	Retry policy
	Filter	filter	Subscription filter
	Enable Message Ordering	enableMessageOrdering	Message ordering
	Service Account
	Enable Exactly Once Delivery	enableExactlyOnceDelivery	Exactly-once delivery
BigQuery Subscriptions	Name	name	Guidelines to name a topic, subscription, schema, or snapshot
	Table	table	Create BigQuery subscriptions
	Use Topic Schema	useTopicSchema	Use topic subscription
	Use Table Schema	useTableSchema	Use table schema
	Write Metadata	writeMetadata	Write metadata
	Drop Unknown Fields	dropUnknownFields	Drop unknown fields
	Ack Deadline Seconds	ackDeadlineSeconds	Acknowledgment deadline
	Retain Acked Messages	retainAckedMessages	Retain acknowledged messages
	Message Retention Duration	messageRetentionDuration	Message retention duration
	Enable Message Ordering	enableMessageOrdering	Message ordering
	Expiration Policy	expirationPolicy	Expiration period
	Filter	filter	Subscription filter
	Dead Letter Topic	deadLetterTopic	Dead letter topic
	Maximum Backoff	maximumBackoff	Retry policy
	Minimum Backoff	minimumBackoff	Retry policy
Cloud Storage Subscriptions	Name	name	Guidelines to name a topic, subscription, schema, or snapshot
	Bucket	bucket	Bucket name
	Filename Prefix	filenamePrefix	Filename prefix, suffix, and datetime
	Filename Suffix	filenameSuffix	Filename prefix, suffix, and datetime
	Filename Datetime Format	filenameDatetimeFormat	Filename prefix, suffix, and datetime
	Max Duration	maxDuration	File batching
	Max Bytes	maxBytes	File batching
	Max Messages	maxMessages	File batching
	Output Format	textConfig or avroConfig	File format
	Write Metadata	writeMetadata	Write metadata
	Use Topic Schema	useTopicSchema	Use topic schema
	Ack Deadline Seconds	ackDeadlineSeconds	Acknowledgment deadline
	Retain Acked Messages		Retain acknowledged messages
	Message Retention Duration	messageRetentionDuration	Message retention duration
	Enable Message Ordering	enableMessageOrdering	Message ordering
	Expiration Policy	expirationPolicy	Expiration period
	Filter	filter	Subscription filter
	Dead Letter Topic	deadLetterTopic	Dead letter topic
	Maximum Backoff	maximumBackoff	Retry policy
	Minimum Backoff	minimumBackoff	Retry policy
Subscription Labels	Key	labels	Reporting usage with labels
	Value	labels	Reporting usage with labels
	Topic Message Retention Duration	topicMessageRetentionDuration	Message retention duration
	Topic KMS Key Name	kmsKeyName	Use a customer-managed encryption key (CMEK)
	Grant BigQuery Project Roles	By default, the BigQuery Metadata Viewer and BigQuery Data Editor roles are granted to default Pub/Sub service account. If you don't want to grant these roles, clear the checkbox.	Assign BigQuery roles to the Pub/Sub service account
	Grant Token Creator	By default, the Service Account Token Creator role is granted to default Pub/Sub service account. If you don't want to grant this role, clear the checkbox.	Set up authentication for Pub/Sub
Schema	Name	name	Important information about schemas
	Type	type	Types of schemas
	Definition	definition	Types of schemas
	Encoding	encoding	Guidelines to associate a schema with a topic