PubsubMessage(mapping=None, *, ignore_unknown_fields=False, **kwargs)
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 <https://cloud.google.com/pubsub/docs/reference/libraries>
__
for more information. See quotas and limits for more information about
message limits.
Attributes | |
---|---|
Name | Description |
data |
bytes
The message data field. If this field is empty, the message must contain at least one attribute. |
attributes |
MutableMapping[str, str]
Attributes for this message. If this field is empty, the message must contain non-empty data. This can be used to filter messages on the subscription. |
message_id |
str
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 Pull call or a push delivery. It
must not be populated by the publisher in a Publish
call.
|
publish_time |
google.protobuf.timestamp_pb2.Timestamp
The time at which the message was published, populated by the server when it receives the Publish call. It must
not be populated by the publisher in a Publish call.
|
ordering_key |
str
If non-empty, identifies related messages for which publish order should be respected. If a Subscription has
enable_message_ordering set to true , messages
published with the same non-empty ordering_key value
will be delivered to subscribers in the order in which they
are received by the Pub/Sub system. All PubsubMessage \ s
published in a given PublishRequest must specify the
same ordering_key value.
|
Classes
AttributesEntry
AttributesEntry(mapping=None, *, ignore_unknown_fields=False, **kwargs)
The abstract base class for a message.
Parameters | |
---|---|
Name | Description |
kwargs |
dict
Keys and values corresponding to the fields of the message. |
mapping |
Union[dict,
A dictionary or message to be used to determine the values for this message. |
ignore_unknown_fields |
Optional(bool)
If True, do not raise errors for unknown fields. Only applied if |