Request for the StreamingPull
streaming RPC method.
This request is used to establish the initial stream as well as to
stream acknowledgements and ack deadline modifications from the client
to the server.
.. attribute:: subscription
Required. The subscription for which to initialize the new
stream. This must be provided in the first request on the
stream, and must not be set in subsequent requests from client
to server. Format is
projects/{project}/subscriptions/{sub}
.
The list of new ack deadlines for the IDs listed in
modify_deadline_ack_ids
. The size of this list must be the
same as the size of modify_deadline_ack_ids
. If it differs
the stream will be aborted with INVALID_ARGUMENT
. Each
element in this list is applied to the element in the same
position in modify_deadline_ack_ids
. The new ack deadline
is with respect to the time this request was sent to the
Pub/Sub system. Must be >= 0. For example, if the value is 10,
the new ack deadline will expire 10 seconds after this request
is received. If the value is 0, the message is immediately
made available for another streaming or non-streaming pull
request. If the value is < 0 (an error), the stream will be
aborted with status INVALID_ARGUMENT
.
Required. The ack deadline to use for the stream. This must be provided in the first request on the stream, but it can also be updated on subsequent requests from client to server. The minimum deadline you can specify is 10 seconds. The maximum deadline you can specify is 600 seconds (10 minutes).