Newer Version Available

This content describes an older version of this product. View Latest

Reference: StreamingChannel

Represents a channel that is the basis for notifying listeners of generic Streaming API events. Available with API version 29.0 and later.

Supported Calls

REST: DELETE, GET, PATCH, POST (query requests are specified in the URI)

SOAP: create(), delete(), describe(), describeLayout(), describeSObjects(), getDeleted(), getUpdated(), query(), retrieve(), undelete(), update()

Special Access Rules

  • This object is available only if Streaming API is enabled for your org.
  • Only users with the Create permission can create this record.
  • You can create a permission set and grant users read and create access to all streaming channels in the org. This access isn’t for a specific channel, like with user sharing.
  • You can apply user sharing to StreamingChannel. You can restrict access to receiving or sending events on a channel by sharing channels with specific users or groups. Channels shared with public read-only or read-write access send events only to clients subscribed to the channel that also are using a user session associated with the set of shared users or groups. Only users with read-write access to a shared channel can generate events on the channel, or modify the actual StreamingChannel record.

Dynamic Streaming Channel

Generic streaming also supports dynamic streaming channel creation, which creates a StreamingChannel when a client first subscribes to the channel. To enable dynamic streaming channels in your org, from Setup, enter User Interface in the Quick Find box, then select User Interface. Enable Enable Dynamic Streaming Channel Creation. You can also enable dynamic channel creation in Metadata API using EventSettings.

Fields

Field Field Type Description
Description string Description of the StreamingChannel. Limit: 255 characters.

Field Properties: Create, Filter, Group, Nillable, Sort, Update

Label: Description

ID ID System field: Globally unique string that identifies a StreamingChannel record.

Field Properties: Default on create, Filter, Group, idLookup, Sort

IsDeleted boolean System field: Indicates whether the record has been moved to the Recycle Bin (true) or not (false).

Field Properties: Default on create, Filter, Group, Sort

IsDynamic boolean true if the channel gets dynamically created on subscribe if necessary, false otherwise.

Field Properties: Default on create, Filter, Group, Sort

LastReferencedDate date The timestamp for when the current user last viewed a record related to this record.

Field Properties: Filter, Sort

LastViewedDate date The timestamp for when the current user last viewed this record. If this value is null, this record might only have been referenced (LastReferencedDate) and not viewed.

Field Properties: Filter, Sort

Name string Required. Descriptive name of the StreamingChannel. Limit: 80 characters, alphanumeric and “_”, “/” characters only. Must start with “/u/”. This value identifies the channel and must be unique.

Field Properties: Create, Filter, Group, idLookup, Sort, Update

Label: Streaming Channel Name

OwnerId reference The ID of the owner of the StreamingChannel.

Field Properties: Create, Default on create, Filter, Group, Sort, Update

Label: Owner Name