Groups Endpoints (2017/01)

Use this endpoint to manage groups and presentation schedules on the network

/groups/regular/

GET

Retrieves a list of groups on the network.

URL Parameters

• marker: A value specifying which page to retrieve. This value is useful if the isTruncated entry in the response body of the previous GET call indicates that the number of Group instances exceeds the pageSize.
• pageSize: The maximum number of Group instances that can be contained in the response body
• filter:  An expression for filtering search results.
• sort: An expression for sorting the search results. The sort expression specifies the entry used for sorting and the ascending/descending (ASC/DESC) sorting order (e.g. "[group].[autorun].[version] DESC")

Response Body

• [int] totalItemCount: The total number of groups on the network that are visible to the user (i.e. viewing permissions may affect this number).
• [int] matchingItemCount: The total number of presentations on the network that match the filter criteria specified in the request.
• [int] pageSize: The maximum number of Group instances that can be returned in a single response
• [bool] isTruncated: A flag indicating whether the totalItemCount exceeds the pageSize
• [string] nextMarker: A value that can be included with a subsequent GET call to return additional results that have been truncated
• [string] sortExpression: The sort expression specified in the URL
• [string] filterExpression: The filter expression specified in the URL
• [Group[]]items: An array of Group object instances. Each Group instance can have the following entries:

  • [int] id: A unique identifier for the Group instance. This value is generated by the server when the group is created.

  • [string] name: The group name

  • [string] creationDate: A UTC timestamp indicating when the group was created on BSN. The date/time is formatted as yyyy-mm-ddThh:mm:ss.sssZ.

  • [string] lastModifiedDate: A UTC timestamp indicating when the group was last modified on BSN. The date/time is formatted as yyyy-mm-ddThh:mm:ss.sssZ.

  • [Autorun] autorun: An array of values indicating the autorun configuration for the group:

    • [string] version: The current BrightAuthor autorun version assigned to the group

    • [bool] isCustom: A flag indicating whether the autorun is a standard BrightAuthor file (false) or a custom-built file (true)

    • [Firmware[]]minFirmwares: An array of Firmware instances indicating the minimum firmware version required to run the autorun on a player. Since different model families can have different minimum firmware requirements, this array can contain more than one Firmware instance.

      • [string] version: The firmware version number
      • [string[]]supportedModels: An array of string values indicating which model numbers (e.g. "XDx233") apply for the minimum-firmware requirement

    • [bool] isRevoked:

  • [string] hD920_970Firmware: The minimum version of device firmware required to play presentations on the HD920/HD970

  • [int] hD920_970FirmwareId: A unique identifier for the HD920/HD970 minimum firmware version

  • [string] hD922_972Firmware: The minimum version of device firmware required to play presentations on the HD922/HD972

  • [int] hD922_972FirmwareId: A unique identifier for the HD922/HD972 minimum firmware version

  • [string] hdX10Firmware: The minimum version of device firmware required to play presentations on the HD210w/HD1010/HD1010w

  • [int] hdX10FirmwareId: A unique identifier for the HD210w/HD1010/HD1010w minimum firmware version

  • [string] hdX20Firmware: The minimum version of device firmware required to play presentations on the AU320/HD220/HD1020/LS322/LS422

  • [int] hdX20FirmwareId: A unique identifier for the AU320/HD220/HD1020/LS322/LS422 minimum firmware version

  • [string] hdX22Firmware: The minimum version of device firmware required to play presentations on the HD222/HD1022

  • [int] hdX22FirmwareId: A unique identifier for the HD222/HD1022 minimum firmware version

  • [string] hdX23Firmware: The minimum version of device firmware required to play presentations on the HD223/HD1023

  • [int] hdX23FirmwareId: A unique identifier for the HD223/HD1023 minimum firmware version

  • [string] lsX23Firmware: The minimum version of device firmware required to play presentations on the LS423

  • [int] lsX23FirmwareId: A unique identifier for the LS423 minimum firmware version

  • [string] hsX23Firmware: The minimum version of device firmware required to play presentations on the HS123

  • [int] hsX23FirmwareId: A unique identifier for the HS123 minimum firmware version

  • [string] hoX23Firmware: The minimum version of device firmware required to play presentations on the HO523

  • [int] hoX23FirmwareId: A unique identifier for the HO523 minimum firmware version

  • [string] xdX30Firmware: The minimum version of device firmware required to play presentations on the XD230/XD1030/XD1230

  • [int] xdX30FirmwareId: A unique identifier for the XD230/XD1030/XD1230 minimum firmware version

  • [string] xdX32Firmware: The minimum version of device firmware required to play presentations on the XD232/XD1032/XD1132

  • [int] xdX32FirmwareId: A unique identifier for the XD232/XD1032/XD1132 minimum firmware version

  • [string] xdX33Firmware: The minimum version of device firmware required to play presentations on the XD233/XD1033

  • [int] xdX33FirmwareId: A unique identifier for the XD233/XD1033 minimum firmware version

  • [string] xtX43Firmware: The minimum version of device firmware required to play presentations on the XT242/XT1042/XT1142

  • [int] xtX43FirmwareId: A unique identifier for the HD222/HD1022 minimum firmware version

  • [string] 4KX42Firmware: The minimum version of device firmware required to play presentations on the AU320/HD220/HD1020/LS322/LS422

  • [int] 4KX42FirmwareId: A unique identifier for the HD222/HD1022 minimum firmware version

  • [bool] enableSerialDebugging:  A flag specifying whether serial debugging should be enabled for all players assigned to the Group instance

  • [bool] enableSystemLogDebugging: A flag specifying whether system log debugging should be enabled for players assigned to the Group instance

  • [bool] enableStorageSpaceLimit: A flag specifying whether player storage devices will be divided into different segments. This allows the user to allot maximum sizes to different segments to ensure that a certain type of data does not take up too much space on the storage device. The "limit" values below will only apply to the player storage if this value is true.

  • [string] storageSpaceLimitUnits: A value specifying whether the following "limit" values are measured in percentages ("Percentage") or megabytes ("Megabyte")

  • [int] publishedDataSizeLimit: The maximum size allotted to all presentation and content files that are written to the storage device during the publish process. This includes audio, video, images, text, and HTML content files.

  • [int] dynamicDataSizeLimit: The maximum size of all dynamic content, including Dynamic Playlists and MRSS feeds. When this segment runs out of space, dynamic content files will be deleted to create space, starting with the oldest files first.

  • [int] htmlDataSizeLimit: The maximum size of the HTML application cache

  • [int] htmlLocalStorageSizeLimit: The maximum size of all JavaScript variables and data

  • [int] webDatabaseSizeLimit: The maximum amount of storage allocated to the IndexedDB web database application

  • [int] devicesCount: The number of players assigned to the Group instance

  • [string[]] devicesHealthStatus: An aggregate of device status information for the group. The array can contain the following string values: "Normal", "Warning", "Error", "No Subscription". The presence of a value indicates that one or more devices in the group is in that state.

  • [Device[]]devices: An array of Device instances indicating devices assigned to the group. The server currently returns a null value for this parameter.

  • [Presentation[]]presentations: An array of Presentation instances indicating presentations scheduled for the group. Each Presentation instance can have the following values:

    • [int] id: A unique identifier for the Presentation instance 

    • [string] name: The presentation name
    • [string] type: The presentation type
  • [Permission[]]permissions: An array of Permission object instances representing permissions rules assigned to the group

POST

Adds a new group to the network.

Request Body

• [string] name: The group name

• [bool] enableSerialDebugging:  A flag specifying whether serial debugging should be enabled for players assigned to the Group instance

• [bool] enableSystemLogDebugging: A flag specifying whether system log debugging should be enabled for players assigned to the Group instance

• [bool] enableStorageSpaceLimit: A flag specifying whether player storage devices will be divided into different segments. This allows the user to allot maximum sizes to different segments to ensure that a certain type of data does not take up too much space on the storage device. The "limit" values below will only apply to the player storage if this value is true.

• [string] storageSpaceLimitUnits: A value specifying whether the following "limit" values are measured in percentages ("Percentage") or megabytes ("Megabyte")

• [int] publishedDataSizeLimit: The maximum size allotted to all presentation and content files that are written to the storage device during the publish process. This includes audio, video, images, text, and HTML content files.

• [int] dynamicDataSizeLimit: The maximum size of all dynamic content, including Dynamic Playlists and MRSS feeds. When this segment runs out of space, dynamic content files will be deleted to create space, starting with the oldest files first.

• [int] htmlDataSizeLimit: The maximum size of the HTML application cache

• [int] htmlLocalStorageSizeLimit: The maximum size of all JavaScript variables and data

• [int] webDatabaseSizeLimit: The maximum amount of storage allocated to the IndexedDB web database application

Response Body

• [int] id: A unique identifier for the Group instance. This value is generated by the server when the group is created.

• [string] name: The group name

• [string] creationDate: A UTC timestamp indicating when the group was created on BSN. The date/time is formatted as yyyy-mm-ddThh:mm:ss.sssZ.

• [string] lastModifiedDate: A UTC timestamp indicating when the group was last modified on BSN. The date/time is formatted as yyyy-mm-ddThh:mm:ss.sssZ.

• [Autorun] autorun: An array of values indicating the autorun configuration for the group. This parameter is null when the group is created.

• [string] hD920_970Firmware: The minimum version of device firmware required to play presentations on the HD920/HD970

• [int] hD920_970FirmwareId: A unique identifier for the HD920/HD970 minimum firmware version

• [string] hD922_972Firmware: The minimum version of device firmware required to play presentations on the HD922/HD972

• [int] hD922_972FirmwareId: A unique identifier for the HD922/HD972 minimum firmware version

• [string] hdX10Firmware: The minimum version of device firmware required to play presentations on the HD210w/HD1010/HD1010w

• [int] hdX10FirmwareId: A unique identifier for the HD210w/HD1010/HD1010w minimum firmware version

• [string] hdX20Firmware: The minimum version of device firmware required to play presentations on the AU320/HD220/HD1020/LS322/LS422

• [int] hdX20FirmwareId: A unique identifier for the AU320/HD220/HD1020/LS322/LS422 minimum firmware version

• [string] hdX22Firmware: The minimum version of device firmware required to play presentations on the HD222/HD1022

• [int] hdX22FirmwareId: A unique identifier for the HD222/HD1022 minimum firmware version

• [string] hdX23Firmware: The minimum version of device firmware required to play presentations on the HD223/HD1023

• [int] hdX23FirmwareId: A unique identifier for the HD223/HD1023 minimum firmware version

• [string] lsX23Firmware: The minimum version of device firmware required to play presentations on the LS423

• [int] lsX23FirmwareId: A unique identifier for the LS423 minimum firmware version

• [string] hsX23Firmware: The minimum version of device firmware required to play presentations on the HS123

• [int] hsX23FirmwareId: A unique identifier for the HS123 minimum firmware version

• [string] hoX23Firmware: The minimum version of device firmware required to play presentations on the HO523

• [int] hoX23FirmwareId: A unique identifier for the HO523 minimum firmware version

• [string] xdX30Firmware: The minimum version of device firmware required to play presentations on the XD230/XD1030/XD1230

• [int] xdX30FirmwareId: A unique identifier for the XD230/XD1030/XD1230 minimum firmware version

• [string] xdX32Firmware: The minimum version of device firmware required to play presentations on the XD232/XD1032/XD1132

• [int] xdX32FirmwareId: A unique identifier for the XD232/XD1032/XD1132 minimum firmware version

• [string] xdX33Firmware: The minimum version of device firmware required to play presentations on the XD233/XD1033

• [int] xdX33FirmwareId: A unique identifier for the XD233/XD1033 minimum firmware version

• [string] xtX43Firmware: The minimum version of device firmware required to play presentations on the XT242/XT1042/XT1142

• [int] xtX43FirmwareId: A unique identifier for the HD222/HD1022 minimum firmware version

• [string] 4KX42Firmware: The minimum version of device firmware required to play presentations on the AU320/HD220/HD1020/LS322/LS422

• [int] 4KX42FirmwareId: A unique identifier for the HD222/HD1022 minimum firmware version

• [bool] enableSerialDebugging:  A flag specifying whether serial debugging should be enabled for all players assigned to the Group instance

• [bool] enableSystemLogDebugging: A flag specifying whether system log debugging should be enabled for players assigned to the Group instance

• [bool] enableStorageSpaceLimit: A flag specifying whether player storage devices will be divided into different segments. This allows the user to allot maximum sizes to different segments to ensure that a certain type of data does not take up too much space on the storage device. The "limit" values below will only apply to the player storage if this value is true.

• [string] storageSpaceLimitUnits: A value specifying whether the following "limit" values are measured in percentages ("Percentage") or megabytes ("Megabyte")

• [int] publishedDataSizeLimit: The maximum size allotted to all presentation and content files that are written to the storage device during the publish process. This includes audio, video, images, text, and HTML content files.

• [int] dynamicDataSizeLimit: The maximum size of all dynamic content, including Dynamic Playlists and MRSS feeds. When this segment runs out of space, dynamic content files will be deleted to create space, starting with the oldest files first.

• [int] htmlDataSizeLimit: The maximum size of the HTML application cache

• [int] htmlLocalStorageSizeLimit: The maximum size of all JavaScript variables and data

• [int] webDatabaseSizeLimit: The maximum amount of storage allocated to the IndexedDB web database application

• [int] devicesCount: The number of players assigned to the Group instance

• [string[]] devicesHealthStatus: An aggregate of device status information for the group. The array can contain the following string values: "Normal", "Warning", "Error", "No Subscription". The presence of a value indicates that one or more devices in the group is in that state.

• [Device[]]devices: An array of Device instances indicating devices assigned to the group. This parameter is null when the group is created.

• [Presentation[]]presentations: An array of Presentation instances indicating presentations scheduled for the group. This parameter is null when the group is created.

• [Permission[]]permissions: An array of Permission object instances representing permissions rules assigned to the group

/groups/count/

GET

Retrieves the number of groups on the network that match the specified filter criteria. If no filter is included, this call returns the total number of groups on the network. 

Parameters

• filter:  An expression for filtering search results.

Response Body

The number of groups is returned as an integer value.

/groups/operations/

GET

Returns Business Operations for groups.

Response Body

• [string] uid: A unique identifier for the Group instance.
• [string] singularName: The name of the operation in singular form. This value is useful for displaying in entity properties dialogs.
• [string] pluralName: The name of the operation in plural form. This value is useful for displaying in User and Role properties dialogs.
• [string] fullName: The name of the current operation along with its parent operations (if any). Since many operation names aren't unique, this value is useful for differentiating similar business operations.
• [string] targetEntity: The object type affected by the operation (in this case, "Group")
• [Operation{}] parent: An Operation instance indicating the operation from which permissions are inherited. This value will be Null if there is no parent operation.
• [Operations[]]descendants: An array of Operation instances that inherit permissions from this operation. This value is Null if there are no descendant operations.
• [Permissions[] permissions: An array of Permission instances indicating permissions associated with this operation

/groups/{group_id||name}/

GET

Returns the Group instance with the specified ID or name.

Response Body

• [int] id: A unique identifier for the Group instance. This value is generated by the server when the group is created.

• [string] name: The group name

• [string] creationDate: A UTC timestamp indicating when the group was created on BSN. The date/time is formatted as yyyy-mm-ddThh:mm:ss.sssZ.

• [string] lastModifiedDate: A UTC timestamp indicating when the group was last modified on BSN. The date/time is formatted as yyyy-mm-ddThh:mm:ss.sssZ.

• [Autorun] autorun: An array of values indicating the autorun configuration for the group:

  • [string] version: The current BrightAuthor autorun version assigned to the group

  • [bool] isCustom: A flag indicating whether the autorun is a standard BrightAuthor file (false) or a custom-built file (true)

  • [Firmware[]]minFirmwares: An array of Firmware instances indicating the minimum firmware version required to run the autorun on a player. Since different model families can have different minimum firmware requirements, this array can contain more than one Firmware instance.

    • [string] version: The firmware version number
    • [string[]]supportedModels: An array of string values indicating which model numbers (e.g. "XDx233") apply for the minimum-firmware requirement

  • [bool] isRevoked:

• [string] hD920_970Firmware: The minimum version of device firmware required to play presentations on the HD920/HD970

• [int] hD920_970FirmwareId: A unique identifier for the HD920/HD970 minimum firmware version

• [string] hD922_972Firmware: The minimum version of device firmware required to play presentations on the HD922/HD972

• [int] hD922_972FirmwareId: A unique identifier for the HD922/HD972 minimum firmware version

• [string] hdX10Firmware: The minimum version of device firmware required to play presentations on the HD210w/HD1010/HD1010w

• [int] hdX10FirmwareId: A unique identifier for the HD210w/HD1010/HD1010w minimum firmware version

• [string] hdX20Firmware: The minimum version of device firmware required to play presentations on the AU320/HD220/HD1020/LS322/LS422

• [int] hdX20FirmwareId: A unique identifier for the AU320/HD220/HD1020/LS322/LS422 minimum firmware version

• [string] hdX22Firmware: The minimum version of device firmware required to play presentations on the HD222/HD1022

• [int] hdX22FirmwareId: A unique identifier for the HD222/HD1022 minimum firmware version

• [string] hdX23Firmware: The minimum version of device firmware required to play presentations on the HD223/HD1023

• [int] hdX23FirmwareId: A unique identifier for the HD223/HD1023 minimum firmware version

• [string] lsX23Firmware: The minimum version of device firmware required to play presentations on the LS423

• [int] lsX23FirmwareId: A unique identifier for the LS423 minimum firmware version

• [string] hsX23Firmware: The minimum version of device firmware required to play presentations on the HS123

• [int] hsX23FirmwareId: A unique identifier for the HS123 minimum firmware version

• [string] hoX23Firmware: The minimum version of device firmware required to play presentations on the HO523

• [int] hoX23FirmwareId: A unique identifier for the HO523 minimum firmware version

• [string] xdX30Firmware: The minimum version of device firmware required to play presentations on the XD230/XD1030/XD1230

• [int] xdX30FirmwareId: A unique identifier for the XD230/XD1030/XD1230 minimum firmware version

• [string] xdX32Firmware: The minimum version of device firmware required to play presentations on the XD232/XD1032/XD1132

• [int] xdX32FirmwareId: A unique identifier for the XD232/XD1032/XD1132 minimum firmware version

• [string] xdX33Firmware: The minimum version of device firmware required to play presentations on the XD233/XD1033

• [int] xdX33FirmwareId: A unique identifier for the XD233/XD1033 minimum firmware version

• [string] xtX43Firmware: The minimum version of device firmware required to play presentations on the XT242/XT1042/XT1142

• [int] xtX43FirmwareId: A unique identifier for the HD222/HD1022 minimum firmware version

• [string] 4KX42Firmware: The minimum version of device firmware required to play presentations on the AU320/HD220/HD1020/LS322/LS422

• [int] 4KX42FirmwareId: A unique identifier for the HD222/HD1022 minimum firmware version

• [bool] enableSerialDebugging:  A flag specifying whether serial debugging should be enabled for all players assigned to the Group instance

• [bool] enableSystemLogDebugging: A flag specifying whether system log debugging should be enabled for players assigned to the Group instance

• [bool] enableStorageSpaceLimit: A flag specifying whether player storage devices will be divided into different segments. This allows the user to allot maximum sizes to different segments to ensure that a certain type of data does not take up too much space on the storage device. The "limit" values below will only apply to the player storage if this value is true.

• [string] storageSpaceLimitUnits: A value specifying whether the following "limit" values are measured in percentages ("Percentage") or megabytes ("Megabyte")

• [int] publishedDataSizeLimit: The maximum size allotted to all presentation and content files that are written to the storage device during the publish process. This includes audio, video, images, text, and HTML content files.

• [int] dynamicDataSizeLimit: The maximum size of all dynamic content, including Dynamic Playlists and MRSS feeds. When this segment runs out of space, dynamic content files will be deleted to create space, starting with the oldest files first.

• [int] htmlDataSizeLimit: The maximum size of the HTML application cache

• [int] htmlLocalStorageSizeLimit: The maximum size of all JavaScript variables and data

• [int] webDatabaseSizeLimit: The maximum amount of storage allocated to the IndexedDB web database application

• [int] devicesCount: The number of players assigned to the Group instance

• [string[]] devicesHealthStatus: An aggregate of device status information for the group. The array can contain the following string values: "Normal", "Warning", "Error", "No Subscription". The presence of a value indicates that one or more devices in the group is in that state.

• [Device[]]devices: An array of Device instances indicating devices assigned to the group. Each Device instance can have the following values:

  • [int] id: A unique identifier for the Device instance
  • [string] serial: The device serial number

• [Presentation[]]presentations: An array of Presentation instances indicating presentations scheduled for the group. Each Presentation instance can have the following values:

  • [int] id: A unique identifier for the Presentation instance 

  • [string] name: The presentation name
  • [string] type: The presentation type
• [Permission[]]permissions: An array of Permission object instances representing permissions rules assigned to the group

PUT

Modifies the specified Group instance using the entries in the request body.

Request Body

• [bool] enableSerialDebugging:  A flag specifying whether serial debugging should be enabled for players assigned to the Group instance

• [bool] enableSystemLogDebugging: A flag specifying whether system log debugging should be enabled for players assigned to the Group instance

• [bool] enableStorageSpaceLimit: A flag specifying whether player storage devices will be divided into different segments. This allows the user to allot maximum sizes to different segments to ensure that a certain type of data does not take up too much space on the storage device. The "limit" values below will only apply to the player storage if this value is true.

• [string] storageSpaceLimitUnits: A value specifying whether the following "limit" values are measured in percentages ("Percentage") or megabytes ("Megabyte")

• [int] publishedDataSizeLimit: The maximum size allotted to all presentation and content files that are written to the storage device during the publish process. This includes audio, video, images, text, and HTML content files.

• [int] dynamicDataSizeLimit: The maximum size of all dynamic content, including Dynamic Playlists and MRSS feeds. When this segment runs out of space, dynamic content files will be deleted to create space, starting with the oldest files first.

• [int] htmlDataSizeLimit: The maximum size of the HTML application cache

• [int] htmlLocalStorageSizeLimit: The maximum size of all JavaScript variables and data

• [int] webDatabaseSizeLimit: The maximum amount of storage allocated to the IndexedDB web database application

Response Body

• [int] id: A unique identifier for the Group instance. This value is generated by the server when the group is created.

• [string] name: The group name

• [string] creationDate: A UTC timestamp indicating when the group was created on BSN. The date/time is formatted as yyyy-mm-ddThh:mm:ss.sssZ.

• [string] lastModifiedDate: A UTC timestamp indicating when the group was last modified on BSN. The date/time is formatted as yyyy-mm-ddThh:mm:ss.sssZ.

• [Autorun] autorun: An array of values indicating the autorun configuration for the group. This parameter is null when the group is created.

• [string] hD920_970Firmware: The minimum version of device firmware required to play presentations on the HD920/HD970

• [int] hD920_970FirmwareId: A unique identifier for the HD920/HD970 minimum firmware version

• [string] hD922_972Firmware: The minimum version of device firmware required to play presentations on the HD922/HD972

• [int] hD922_972FirmwareId: A unique identifier for the HD922/HD972 minimum firmware version

• [string] hdX10Firmware: The minimum version of device firmware required to play presentations on the HD210w/HD1010/HD1010w

• [int] hdX10FirmwareId: A unique identifier for the HD210w/HD1010/HD1010w minimum firmware version

• [string] hdX20Firmware: The minimum version of device firmware required to play presentations on the AU320/HD220/HD1020/LS322/LS422

• [int] hdX20FirmwareId: A unique identifier for the AU320/HD220/HD1020/LS322/LS422 minimum firmware version

• [string] hdX22Firmware: The minimum version of device firmware required to play presentations on the HD222/HD1022

• [int] hdX22FirmwareId: A unique identifier for the HD222/HD1022 minimum firmware version

• [string] hdX23Firmware: The minimum version of device firmware required to play presentations on the HD223/HD1023

• [int] hdX23FirmwareId: A unique identifier for the HD223/HD1023 minimum firmware version

• [string] lsX23Firmware: The minimum version of device firmware required to play presentations on the LS423

• [int] lsX23FirmwareId: A unique identifier for the LS423 minimum firmware version

• [string] hsX23Firmware: The minimum version of device firmware required to play presentations on the HS123

• [int] hsX23FirmwareId: A unique identifier for the HS123 minimum firmware version

• [string] hoX23Firmware: The minimum version of device firmware required to play presentations on the HO523

• [int] hoX23FirmwareId: A unique identifier for the HO523 minimum firmware version

• [string] xdX30Firmware: The minimum version of device firmware required to play presentations on the XD230/XD1030/XD1230

• [int] xdX30FirmwareId: A unique identifier for the XD230/XD1030/XD1230 minimum firmware version

• [string] xdX32Firmware: The minimum version of device firmware required to play presentations on the XD232/XD1032/XD1132

• [int] xdX32FirmwareId: A unique identifier for the XD232/XD1032/XD1132 minimum firmware version

• [string] xdX33Firmware: The minimum version of device firmware required to play presentations on the XD233/XD1033

• [int] xdX33FirmwareId: A unique identifier for the XD233/XD1033 minimum firmware version

• [string] xtX43Firmware: The minimum version of device firmware required to play presentations on the XT242/XT1042/XT1142

• [int] xtX43FirmwareId: A unique identifier for the HD222/HD1022 minimum firmware version

• [string] 4KX42Firmware: The minimum version of device firmware required to play presentations on the AU320/HD220/HD1020/LS322/LS422

• [int] 4KX42FirmwareId: A unique identifier for the HD222/HD1022 minimum firmware version

• [bool] enableSerialDebugging:  A flag specifying whether serial debugging should be enabled for all players assigned to the Group instance

• [bool] enableSystemLogDebugging: A flag specifying whether system log debugging should be enabled for players assigned to the Group instance

• [bool] enableStorageSpaceLimit: A flag specifying whether player storage devices will be divided into different segments. This allows the user to allot maximum sizes to different segments to ensure that a certain type of data does not take up too much space on the storage device. The "limit" values below will only apply to the player storage if this value is true.

• [string] storageSpaceLimitUnits: A value specifying whether the following "limit" values are measured in percentages ("Percentage") or megabytes ("Megabyte")

• [int] publishedDataSizeLimit: The maximum size allotted to all presentation and content files that are written to the storage device during the publish process. This includes audio, video, images, text, and HTML content files.

• [int] dynamicDataSizeLimit: The maximum size of all dynamic content, including Dynamic Playlists and MRSS feeds. When this segment runs out of space, dynamic content files will be deleted to create space, starting with the oldest files first.

• [int] htmlDataSizeLimit: The maximum size of the HTML application cache

• [int] htmlLocalStorageSizeLimit: The maximum size of all JavaScript variables and data

• [int] webDatabaseSizeLimit: The maximum amount of storage allocated to the IndexedDB web database application

• [int] devicesCount: The number of players assigned to the Group instance

• [string[]] devicesHealthStatus: An aggregate of device status information for the group. The array can contain the following string values: "Normal", "Warning", "Error", "No Subscription". The presence of a value indicates that one or more devices in the group is in that state.

• [Device[]]devices: An array of Device instances indicating devices assigned to the group. This parameter is null when the group is created.

• [Presentation[]]presentations: An array of Presentation instances indicating presentations scheduled for the group. This parameter is null when the group is created.

• [Permission[]]permissions: An array of Permission object instances representing permissions rules assigned to the group

DELETE

Removes the specified Group instance from the network. The server returns code 204 if successful and code 404 if the Group instance could not be found.

/groups/{group_id||name}/schedule/

GET

Returns the schedule for the specified Group instance. The schedule is specified as a list of ScheduledPresentation intances.

URL Parameters

• marker: A value specifying which page to retrieve. This value is useful if the isTruncated entry in the response body of the previous GET call indicates that the number of ScheduledPresentation instances exceeds the pageSize.
• pageSize: The maximum number of ScheduledPresentation instances that can be contained in the response body
• filter:  An expression for filtering search results.
• sort: An expression for sorting the search results. The sort expression specifies the entry used for sorting and the ascending/descending (ASC/DESC) sorting order (e.g. "[ScheduledPresentation].[presentationName] DESC")

Response Body

• [int] totalItemCount: The total number of groups on the network that are visible to the user (i.e. viewing permissions may affect this number).
• [int] matchingItemCount: The total number of presentations on the network that match the filter criteria specified in the request.
• [int] pageSize: The maximum number of Group instances that can be returned in a single response
• [bool] isTruncated: A flag indicating whether the totalItemCount exceeds the pageSize
• [string] nextMarker: A value that can be included with a subsequent GET call to return additional results that have been truncated
• [string] sortExpression: The sort expression specified in the URL
• [string] filterExpression: The filter expression specified in the URL
• [Group[]]items: An array of ScheduledPresentation object instances. Each ScheduledPresentation instance can have the following entries:

  • [int] id: A unique identifier for the ScheduledPresentation instance

  • [int] presentationId: The identifier for the scheduled presentation

  • [string] presentationName: The name of the scheduled presentation

  • [bool] isRecurrent: A flag indicating whether the scheduled playback recurrs every week

  • [string] eventDate: A UTC timestamp specifying the date when a non-recurrent presentation should begin playing. This value is null for recurring presentations.

  • [string] startTime: The time of day when playback begins. The time is formatted as "HH:MM:SS".

  • [string] duration: The duration of the playback window. The time is formatted as "HH:MM:SS".

    Note

     An all-day playback window is configured with a startTime of "00:00:00" and a duration of "1.00:00:00".

  • [string] recurrenceStartDate: A UTC timestamp indicating when recurring playback begins. If this value is null, then recurring playback begins immediately when scheduled.

  • [string] recurrenceEndDate: A UTC timestamp indicating when recurring playback ends. If this value is null, then recurring playback will not end.

  • [string] daysOfWeek: The days of week during which the recurring schedule is active. The days are specified as a string list (e.g. "Monday, Wednesday, Friday"). An "EveryDay" value can be used to specify all days of the week.

  • [string] creationDate: A UTC timestamp indicating when the ScheduledPresentation instance was created on BSN. The date/time is formatted as yyyy-mm-ddThh:mm:ss.sssZ.

  • [string] lastModifiedDate: A UTC timestamp indicating when the ScheduledPresentation instance was last modified on BSN. The date/time is formatted as yyyy-mm-ddThh:mm:ss.sssZ.

  • [string] expirationDate:  A UTC timestamp indicating when the ScheduledPresentaiton instance will expire. If this value is null, then the instance will never expire.

  • [string] interruptScheduling: 

POST

Adds a new ScheduledPresentation instance to the specified Group instance.

Request Body

• [int] presentationId: The identifier of the presentation to schedule

• [bool] isRecurrent: A flag indicating whether the scheduled playback recurrs every week

• [string] eventDate: A UTC timestamp specifying the date when a non-recurrent presentation should begin playing. This value is null for recurring presentations.

• [string] startTime: The time of day when playback begins. The time is formatted as "HH:MM:SS".

• [string] duration: The duration of the playback window. The time is formatted as "HH:MM:SS".

  Note

   An all-day playback window is configured with a startTime of "00:00:00" and a duration of "1.00:00:00".

• [string] recurrenceStartDate: A UTC timestamp indicating when recurring playback begins. If this value is null, then recurring playback begins immediately when scheduled.

• [string] recurrenceEndDate: A UTC timestamp indicating when recurring playback ends. If this value is null, then recurring playback will not end.

• [string] daysOfWeek: The days of week during which the recurring schedule is active. The days are specified as a string list (e.g. "Monday, Wednesday, Friday"). An "EveryDay" value can be used to specify all days of the week.

• [string] expirationDate:  A UTC timestamp indicating when the ScheduledPresentaiton instance will expire. If this value is null, then the instance will never expire.

• [string] interruptScheduling: 

Response Body

• [int] id: A unique identifier for the ScheduledPresentation instance

• [int] presentationId: The identifier for the scheduled presentation

• [string] presentationName: The name of the scheduled presentation

• [bool] isRecurrent: A flag indicating whether the scheduled playback recurrs every week

• [string] eventDate: A UTC timestamp specifying the date when a non-recurrent presentation should begin playing. This value is null for recurring presentations.

• [string] startTime: The time of day when playback begins. The time is formatted as "HH:MM:SS".

• [string] duration: The duration of the playback window. The time is formatted as "HH:MM:SS".

• [string] recurrenceStartDate: A UTC timestamp indicating when recurring playback begins. If this value is null, then recurring playback begins immediately when scheduled.

• [string] recurrenceEndDate: A UTC timestamp indicating when recurring playback ends. If this value is null, then recurring playback will not end.

• [string] daysOfWeek: The days of week during which the recurring schedule is active. The days are specified as a string list (e.g. "Monday, Wednesday, Friday"). An "EveryDay" value can be used to specify all days of the week.

• [string] creationDate: A UTC timestamp indicating when the ScheduledPresentation instance was created on BSN. The date/time is formatted as yyyy-mm-ddThh:mm:ss.sssZ.

• [string] lastModifiedDate: A UTC timestamp indicating when the ScheduledPresentation instance was last modified on BSN. The date/time is formatted as yyyy-mm-ddThh:mm:ss.sssZ.

• [string] expirationDate:  A UTC timestamp indicating when the ScheduledPresentaiton instance will expire. If this value is null, then the instance will never expire.

• [string] interruptScheduling: