Share via


GrooveSubscriptions Web Service

The GrooveSubscriptions service provides access to events that indicate changes to Groove data or the Groove environment.

XML Definitions

WSDL

GrooveApplication.wsdl 2.0

with references to:

  • Core.xsd 2.0

  • Calendar.xsd 2.0

SOAP Operation Namespace

http://webservices.groove.net/Groove/2.0/Subscriptions/  

HTTP Post URL

https://localhost:port-number/GWS/Groove/2.0/Subscriptions

Operations and Complex Types

The following sections describe the GrooveSubscriptions operations and complex types.

Operations

Operation Description

Create

Creates a new subscription to events originated by the specified event source.

Create2

Creates a new subscription to events originated by the specified event source. Optionally, restricts events to those that meet the specified query.

CreateAggregated2

Creates a new aggregated subscription to events originated by sources that meet the specified description. You can use the aggregated subscription to monitor events originated by multiple event sources. This can improve efficiency compared to the simple subscription created by the Create method. The subscription automatically includes new sources of events that meet the specified source description.

CreateAggregated

Creates a new aggregated subscription. This operation provides a more restricted functionality than CreateAggregated2. CreateAggregated is provided for compatibility with previous versions of Groove.

Delete

Deletes a subscription and any events that are currently on the queue. If there are no remaining subscriptions on the queue, Groove will delete the queue.

Update

Renews the subscription for the specified number of hours.

Complex Types

Complex type Description

AggregateData

Contains information about the subscription created and any sources found in the scope.

Remarks

To monitor events, first create a subscription for them using Create or CreateAggregated2. Then periodically retrieve events using the GrooveEvents.Read or GrooveEvents.ReadExtended operation. Finally, when the subscription is no longer needed, close it using Delete.

See Also

Reference

GrooveEvents Web Service

Concepts

Handling Groove Web Services Events