Cloud Pub/Sub API

Service: pubsub.googleapis.com

To call this service, we recommend that you use the Google-provided client libraries. If your application needs to use your own libraries to call this service, use the following information when you make the API requests.

Discovery document

A Discovery Document is a machine-readable specification for describing and consuming REST APIs. It is used to build client libraries, IDE plugins, and other tools that interact with Google APIs. One service may provide multiple discovery documents. This service provides the following discovery document:

Service endpoint

A service endpoint is a base URL that specifies the network address of an API service. One service might have multiple service endpoints. This service has the following service endpoint and all URIs below are relative to this service endpoint:

  • https://pubsub.googleapis.com

REST Resource: v1.projects.schemas

Methods
create POST /v1/{parent}/schemas
Creates a schema.
delete DELETE /v1/{name}
Deletes a schema.
get GET /v1/{name}
Gets a schema.
list GET /v1/{parent}/schemas
Lists schemas in a project.
validate POST /v1/{parent}/schemas:validate
Validates a schema.
validateMessage POST /v1/{parent}/schemas:validateMessage
Validates a message against a schema.

REST Resource: v1.projects.snapshots

Methods
create PUT /v1/{name}
Creates a snapshot from the requested subscription.
delete DELETE /v1/{snapshot}
Removes an existing snapshot.
getIamPolicy GET /v1/{resource}:getIamPolicy
Gets the access control policy for a resource.
list GET /v1/{project}/snapshots
Lists the existing snapshots.
patch PATCH /v1/{snapshot.name}
Updates an existing snapshot.
setIamPolicy POST /v1/{resource}:setIamPolicy
Sets the access control policy on the specified resource.
testIamPermissions POST /v1/{resource}:testIamPermissions
Returns permissions that a caller has on the specified resource.

REST Resource: v1.projects.subscriptions

Methods
acknowledge POST /v1/{subscription}:acknowledge
Acknowledges the messages associated with the ack_ids in the AcknowledgeRequest.
create PUT /v1/{name}
Creates a subscription to a given topic.
delete DELETE /v1/{subscription}
Deletes an existing subscription.
detach POST /v1/{subscription}:detach
Detaches a subscription from this topic.
get GET /v1/{subscription}
Gets the configuration details of a subscription.
getIamPolicy GET /v1/{resource}:getIamPolicy
Gets the access control policy for a resource.
list GET /v1/{project}/subscriptions
Lists matching subscriptions.
modifyAckDeadline POST /v1/{subscription}:modifyAckDeadline
Modifies the ack deadline for a specific message.
modifyPushConfig POST /v1/{subscription}:modifyPushConfig
Modifies the PushConfig for a specified subscription.
patch PATCH /v1/{subscription.name}
Updates an existing subscription.
pull POST /v1/{subscription}:pull
Pulls messages from the server.
seek POST /v1/{subscription}:seek
Seeks an existing subscription to a point in time or to a given snapshot, whichever is provided in the request.
setIamPolicy POST /v1/{resource}:setIamPolicy
Sets the access control policy on the specified resource.
testIamPermissions POST /v1/{resource}:testIamPermissions
Returns permissions that a caller has on the specified resource.

REST Resource: v1.projects.topics

Methods
create PUT /v1/{name}
Creates the given topic with the given name.
delete DELETE /v1/{topic}
Deletes the topic with the given name.
get GET /v1/{topic}
Gets the configuration of a topic.
getIamPolicy GET /v1/{resource}:getIamPolicy
Gets the access control policy for a resource.
list GET /v1/{project}/topics
Lists matching topics.
patch PATCH /v1/{topic.name}
Updates an existing topic.
publish POST /v1/{topic}:publish
Adds one or more messages to the topic.
setIamPolicy POST /v1/{resource}:setIamPolicy
Sets the access control policy on the specified resource.
testIamPermissions POST /v1/{resource}:testIamPermissions
Returns permissions that a caller has on the specified resource.

REST Resource: v1.projects.topics.snapshots

Methods
list GET /v1/{topic}/snapshots
Lists the names of the snapshots on this topic.

REST Resource: v1.projects.topics.subscriptions

Methods
list GET /v1/{topic}/subscriptions
Lists the names of the attached subscriptions on this topic.