Method: projects.subscriptions.pull

Pulls messages from the server. The server may return UNAVAILABLE if there are too many concurrent pull requests pending for the given subscription.

HTTP request

POST https://pubsub.googleapis.com/v1/{subscription}:pull

Path parameters

Parameters
subscription

string

Required. The subscription from which messages should be pulled. Format is projects/{project}/subscriptions/{sub}.

Request body

The request body contains data with the following structure:

JSON representation 
{
  "returnImmediately": boolean,
  "maxMessages": integer
}
Fields
returnImmediately
(deprecated)

boolean

Optional. If this field set to true, the system will respond immediately even if it there are no messages available to return in the subscriptions.pull response. Otherwise, the system may wait (for a bounded amount of time) until at least one message is available, rather than returning no messages. Warning: setting this field to true is discouraged because it adversely impacts the performance of subscriptions.pull operations. We recommend that users do not set this field.
maxMessages

integer

Required. The maximum number of messages to return for this request. Must be a positive integer. The Pub/Sub system may return fewer than the number specified.

Response body

If successful, the response body contains data with the following structure:

Response for the subscriptions.pull method.

JSON representation 
{
  "receivedMessages": [
    {
      object (ReceivedMessage)
    }
  ]
}
Fields
receivedMessages[]

object (ReceivedMessage)

Received Pub/Sub messages. The list will be empty if there are no more messages available in the backlog. For JSON, the response can be entirely empty. The Pub/Sub system may return fewer than the maxMessages requested even if there are more messages available in the backlog.

Authorization Scopes

Requires one of the following OAuth scopes:

  • https://www.googleapis.com/auth/pubsub
  • https://www.googleapis.com/auth/cloud-platform

For more information, see the Authentication Overview.

ReceivedMessage

A message and its corresponding acknowledgment ID.

JSON representation 
{
  "ackId": string,
  "message": {
    object (PubsubMessage)
  }
}
Fields
ackId

string

This ID can be used to acknowledge the received message.
message

object (PubsubMessage)

The message.

Try it!