Cloud PubSub V1 Client - Class ReceivedMessage (1.42.1)

Reference documentation and code samples for the Cloud PubSub V1 Client class ReceivedMessage.

A message and its corresponding acknowledgment ID.

Generated from protobuf message google.pubsub.v1.ReceivedMessage

Methods

__construct

Constructor.

Parameters
NameDescription
data array

Optional. Data for populating the Message object.

↳ ack_id string

This ID can be used to acknowledge the received message.

↳ message Google\Cloud\PubSub\V1\PubsubMessage

The message.

↳ delivery_attempt int

The approximate number of times that Cloud Pub/Sub has attempted to deliver the associated message to a subscriber. More precisely, this is 1 + (number of NACKs) + (number of ack_deadline exceeds) for this message. A NACK is any call to ModifyAckDeadline with a 0 deadline. An ack_deadline exceeds event is whenever a message is not acknowledged within ack_deadline. Note that ack_deadline is initially Subscription.ackDeadlineSeconds, but may get extended automatically by the client library. Upon the first delivery of a given message, delivery_attempt will have a value of 1. The value is calculated at best effort and is approximate. If a DeadLetterPolicy is not set on the subscription, this will be 0.

getAckId

This ID can be used to acknowledge the received message.

Returns
TypeDescription
string

setAckId

This ID can be used to acknowledge the received message.

Parameter
NameDescription
var string
Returns
TypeDescription
$this

getMessage

The message.

Returns
TypeDescription
Google\Cloud\PubSub\V1\PubsubMessage|null

hasMessage

clearMessage

setMessage

The message.

Parameter
NameDescription
var Google\Cloud\PubSub\V1\PubsubMessage
Returns
TypeDescription
$this

getDeliveryAttempt

The approximate number of times that Cloud Pub/Sub has attempted to deliver the associated message to a subscriber.

More precisely, this is 1 + (number of NACKs) + (number of ack_deadline exceeds) for this message. A NACK is any call to ModifyAckDeadline with a 0 deadline. An ack_deadline exceeds event is whenever a message is not acknowledged within ack_deadline. Note that ack_deadline is initially Subscription.ackDeadlineSeconds, but may get extended automatically by the client library. Upon the first delivery of a given message, delivery_attempt will have a value of 1. The value is calculated at best effort and is approximate. If a DeadLetterPolicy is not set on the subscription, this will be 0.

Returns
TypeDescription
int

setDeliveryAttempt

The approximate number of times that Cloud Pub/Sub has attempted to deliver the associated message to a subscriber.

More precisely, this is 1 + (number of NACKs) + (number of ack_deadline exceeds) for this message. A NACK is any call to ModifyAckDeadline with a 0 deadline. An ack_deadline exceeds event is whenever a message is not acknowledged within ack_deadline. Note that ack_deadline is initially Subscription.ackDeadlineSeconds, but may get extended automatically by the client library. Upon the first delivery of a given message, delivery_attempt will have a value of 1. The value is calculated at best effort and is approximate. If a DeadLetterPolicy is not set on the subscription, this will be 0.

Parameter
NameDescription
var int
Returns
TypeDescription
$this