Optional. The time to seek to. Messages retained in the subscription that were published before this time are marked as acknowledged, and messages retained in the subscription that were published after this time are marked as unacknowledged. Note that this operation affects only those messages retained in the subscription (configured by the combination ofmessage_retention_durationandretain_acked_messages). For example, iftimecorresponds to a point before the message retention window (or to a point before the system's notion of the subscription creation time), only retained messages will be marked as unacknowledged, and already-expunged messages will not be restored.
↳ snapshot
string
Optional. The snapshot to seek to. The snapshot's topic must be the same as that of the provided subscription. Format isprojects/{project}/snapshots/{snap}.
getSubscription
Required. The subscription to affect.
Returns
Type
Description
string
setSubscription
Required. The subscription to affect.
Parameter
Name
Description
var
string
Returns
Type
Description
$this
getTime
Optional. The time to seek to.
Messages retained in the subscription that were published before this
time are marked as acknowledged, and messages retained in the
subscription that were published after this time are marked as
unacknowledged. Note that this operation affects only those messages
retained in the subscription (configured by the combination ofmessage_retention_durationandretain_acked_messages). For example,
iftimecorresponds to a point before the message retention
window (or to a point before the system's notion of the subscription
creation time), only retained messages will be marked as unacknowledged,
and already-expunged messages will not be restored.
Messages retained in the subscription that were published before this
time are marked as acknowledged, and messages retained in the
subscription that were published after this time are marked as
unacknowledged. Note that this operation affects only those messages
retained in the subscription (configured by the combination ofmessage_retention_durationandretain_acked_messages). For example,
iftimecorresponds to a point before the message retention
window (or to a point before the system's notion of the subscription
creation time), only retained messages will be marked as unacknowledged,
and already-expunged messages will not be restored.
Optional. The snapshot to seek to. The snapshot's topic must be the same
as that of the provided subscription. Format isprojects/{project}/snapshots/{snap}.
Returns
Type
Description
string
hasSnapshot
setSnapshot
Optional. The snapshot to seek to. The snapshot's topic must be the same
as that of the provided subscription. Format isprojects/{project}/snapshots/{snap}.
[[["Easy to understand","easyToUnderstand","thumb-up"],["Solved my problem","solvedMyProblem","thumb-up"],["Other","otherUp","thumb-up"]],[["Hard to understand","hardToUnderstand","thumb-down"],["Incorrect information or sample code","incorrectInformationOrSampleCode","thumb-down"],["Missing the information/samples I need","missingTheInformationSamplesINeed","thumb-down"],["Other","otherDown","thumb-down"]],["Last updated 2025-09-04 UTC."],[],[],null,["# Cloud PubSub V1 Client - Class SeekRequest (2.13.2)\n\nVersion latestkeyboard_arrow_down\n\n- [2.13.2 (latest)](/php/docs/reference/cloud-pubsub/latest/V1.SeekRequest)\n- [2.13.1](/php/docs/reference/cloud-pubsub/2.13.1/V1.SeekRequest)\n- [2.12.0](/php/docs/reference/cloud-pubsub/2.12.0/V1.SeekRequest)\n- [2.11.3](/php/docs/reference/cloud-pubsub/2.11.3/V1.SeekRequest)\n- [2.10.1](/php/docs/reference/cloud-pubsub/2.10.1/V1.SeekRequest)\n- [2.9.1](/php/docs/reference/cloud-pubsub/2.9.1/V1.SeekRequest)\n- [2.8.2](/php/docs/reference/cloud-pubsub/2.8.2/V1.SeekRequest)\n- [2.7.0](/php/docs/reference/cloud-pubsub/2.7.0/V1.SeekRequest)\n- [2.6.0](/php/docs/reference/cloud-pubsub/2.6.0/V1.SeekRequest)\n- [2.5.2](/php/docs/reference/cloud-pubsub/2.5.2/V1.SeekRequest)\n- [2.4.0](/php/docs/reference/cloud-pubsub/2.4.0/V1.SeekRequest)\n- [2.3.0](/php/docs/reference/cloud-pubsub/2.3.0/V1.SeekRequest)\n- [2.2.1](/php/docs/reference/cloud-pubsub/2.2.1/V1.SeekRequest)\n- [2.1.2](/php/docs/reference/cloud-pubsub/2.1.2/V1.SeekRequest)\n- [1.50.0](/php/docs/reference/cloud-pubsub/1.50.0/V1.SeekRequest)\n- [1.49.0](/php/docs/reference/cloud-pubsub/1.49.0/V1.SeekRequest)\n- [1.48.0](/php/docs/reference/cloud-pubsub/1.48.0/V1.SeekRequest)\n- [1.47.0](/php/docs/reference/cloud-pubsub/1.47.0/V1.SeekRequest)\n- [1.46.5](/php/docs/reference/cloud-pubsub/1.46.5/V1.SeekRequest)\n- [1.45.2](/php/docs/reference/cloud-pubsub/1.45.2/V1.SeekRequest)\n- [1.44.0](/php/docs/reference/cloud-pubsub/1.44.0/V1.SeekRequest)\n- [1.43.2](/php/docs/reference/cloud-pubsub/1.43.2/V1.SeekRequest)\n- [1.42.1](/php/docs/reference/cloud-pubsub/1.42.1/V1.SeekRequest)\n- [1.41.3](/php/docs/reference/cloud-pubsub/1.41.3/V1.SeekRequest)\n- [1.40.1](/php/docs/reference/cloud-pubsub/1.40.1/V1.SeekRequest)\n- [1.39.3](/php/docs/reference/cloud-pubsub/1.39.3/V1.SeekRequest) \nReference documentation and code samples for the Cloud PubSub V1 Client class SeekRequest.\n\nRequest for the `Seek` method.\n\nGenerated from protobuf message `google.pubsub.v1.SeekRequest`\n\nNamespace\n---------\n\nGoogle \\\\ Cloud \\\\ PubSub \\\\ V1\n\nMethods\n-------\n\n### __construct\n\nConstructor.\n\n### getSubscription\n\nRequired. The subscription to affect.\n\n### setSubscription\n\nRequired. The subscription to affect.\n\n### getTime\n\nOptional. The time to seek to.\n\nMessages retained in the subscription that were published before this\ntime are marked as acknowledged, and messages retained in the\nsubscription that were published after this time are marked as\nunacknowledged. Note that this operation affects only those messages\nretained in the subscription (configured by the combination of\n`message_retention_duration` and `retain_acked_messages`). For example,\nif `time` corresponds to a point before the message retention\nwindow (or to a point before the system's notion of the subscription\ncreation time), only retained messages will be marked as unacknowledged,\nand already-expunged messages will not be restored.\n\n### hasTime\n\n### setTime\n\nOptional. The time to seek to.\n\nMessages retained in the subscription that were published before this\ntime are marked as acknowledged, and messages retained in the\nsubscription that were published after this time are marked as\nunacknowledged. Note that this operation affects only those messages\nretained in the subscription (configured by the combination of\n`message_retention_duration` and `retain_acked_messages`). For example,\nif `time` corresponds to a point before the message retention\nwindow (or to a point before the system's notion of the subscription\ncreation time), only retained messages will be marked as unacknowledged,\nand already-expunged messages will not be restored.\n\n### getSnapshot\n\nOptional. The snapshot to seek to. The snapshot's topic must be the same\nas that of the provided subscription. Format is\n`projects/{project}/snapshots/{snap}`.\n\n### hasSnapshot\n\n### setSnapshot\n\nOptional. The snapshot to seek to. The snapshot's topic must be the same\nas that of the provided subscription. Format is\n`projects/{project}/snapshots/{snap}`.\n\n### getTarget"]]