A message that is published by publishers and consumed by subscribers. The message must contain either a non-empty data field or at least one attribute. Note that client libraries represent this object differently depending on the language. See the corresponding client library documentation for more information. See Quotas and limits for more information about message limits.

JSON representation
  "data": string,
  "attributes": {
    string: string,
  "messageId": string,
  "publishTime": string

string (bytes format)

The message data field. If this field is empty, the message must contain at least one attribute.

A base64-encoded string.


map (key: string, value: string)

Optional attributes for this message.

An object containing a list of "key": value pairs. Example: { "name": "wrench", "mass": "1.3kg", "count": "3" }.



ID of this message, assigned by the server when the message is published. Guaranteed to be unique within the topic. This value may be read by a subscriber that receives a PubsubMessage via a subscriptions.pull call or a push delivery. It must not be populated by the publisher in a topics.publish call.


string (Timestamp format)

The time at which the message was published, populated by the server when it receives the topics.publish call. It must not be populated by the publisher in a topics.publish call.

Was this page helpful? Let us know how we did:

Send feedback about...

Cloud Pub/Sub