Class Subscription
- All Implemented Interfaces:
ICreatable,IUpdatable
A Subscription allows a client app to receive change notifications about changes to data in Microsoft Graph. It identifies the resource to monitor, the types of changes to notify on, the notification endpoint, and the time the subscription expires.
Example usage:
// Subscribe to new messages
Subscription subscription = new Subscription();
subscription.setResource("me/messages");
subscription.setNotificationUrl("https://example.com/notifications");
subscription.setClientState("secretClientState");
- Since:
- 1.0
- See Also:
- subscription resource type
-
Constructor Summary
Constructors -
Method Summary
Modifier and TypeMethodDescriptiongetId()booleanvoidsetApplicationId(String applicationId)voidsetClientState(String clientState)voidsetEncryptionCertificate(String encryptionCertificate)voidsetEncryptionCertificateId(String encryptionCertificateId)voidsetExpirationTime(Date expirationTime)voidvoidsetIncludeResourceData(boolean includeResourceData)voidsetLatestSupportedTlsVersion(LatestSupportedTlsVersion latestSupportedTlsVersion)voidsetLifecycleNotificationUrl(String lifecycleNotificationUrl)voidsetNotificationContentType(String notificationContentType)voidsetNotificationUrl(String notificationUrl)voidsetResource(String resource)Converts this object to its JSON representation for creation.toString()Converts this object to its JSON representation for update.toUpdateJson(List<String> propertyNames)Converts this object to JSON for update with specific properties.
-
Constructor Details
-
Subscription
public Subscription() -
Subscription
-
-
Method Details
-
toCreateJson
Description copied from interface:ICreatableConverts this object to its JSON representation for creation.This method generates a JSON string containing all properties needed to create a new instance of this resource in Microsoft Graph. Only properties appropriate for creation should be included (e.g., excluding read-only properties like ID, createdTime, etc.).
- Specified by:
toCreateJsonin interfaceICreatable- Returns:
- JSON string representation for creating this resource
-
toUpdateJson
Description copied from interface:IUpdatableConverts this object to its JSON representation for update.This method generates a JSON string containing all modified properties that should be updated in Microsoft Graph. Only writeable properties with non-null values are typically included.
- Specified by:
toUpdateJsonin interfaceIUpdatable- Returns:
- JSON string representation for updating this resource
-
toUpdateJson
Description copied from interface:IUpdatableConverts this object to JSON for update with specific properties.This method generates a JSON string containing only the specified properties. This enables partial updates where only certain fields need to be modified, reducing payload size and avoiding unintended changes to other properties.
- Specified by:
toUpdateJsonin interfaceIUpdatable- Parameters:
propertyNames- List of property names to include in the JSON. If null or empty, all modified properties are included.- Returns:
- JSON string representation for updating specific properties
-
toString
-
getApplicationId
-
setApplicationId
-
getChangeTypes
-
getClientState
-
setClientState
-
getCreatorId
-
getEncryptionCertificate
-
setEncryptionCertificate
-
getEncryptionCertificateId
-
setEncryptionCertificateId
-
getExpirationTime
-
setExpirationTime
-
getId
-
setId
-
isIncludeResourceData
public boolean isIncludeResourceData() -
setIncludeResourceData
public void setIncludeResourceData(boolean includeResourceData) -
getLatestSupportedTlsVersion
-
setLatestSupportedTlsVersion
-
getLifecycleNotificationUrl
-
setLifecycleNotificationUrl
-
getNotificationContentType
-
setNotificationContentType
-
getNotificationUrl
-
setNotificationUrl
-
getResource
-
setResource
-