...
The Group entity has the following properties:
[int] Id:(read only) The identifier and primary key of the Group instance.[string] Name: The user-defined name of the Group instance. This is an alternate key and must be unique within the scope of the account.[DateTime] CreationDate:(read only) A UTC timestamp indicating when the Group instance was created within the BrightSign Network.[string] MinAutorunVersion:(read only) The minimum version of device autorun required to play presentations scheduled for the Group instance.[string] HD9XXFirmware: The minimum version of device firmware required to play presentations for the HD970 model.[string] HDx10Firmware: The minimum version of device firmware required to play presentations for the following player models: HD210w, HD1010, HD1010w.[string] HDx20Firmware: The minimum version of device firmware required to play presentations for the following player models: AU320, HD220, HD1020.[string] HDx22Firmware: The minimum version of device firmware required to play presentations for the following player models: HD222, HD1022.[string] XDx30Firmware: The minimum version of device firmware required to play presentations for the following player models: XD230, XD1030, XD1230.[string] XDx32Firmware: The minimum version of device firmware required to play presentations for the following player models: XD232, XD1032, XD1132.[string] 4Kx42Firmware: The minimum version of device firmware required to play presentations for the following player models: 4K242, 4K1042, 4K1142.[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 all players assigned to the Group instance.[int] DevicesCount:(read only) An integer indicating the number of players assigned to the Group instance.[bool] EnableStorageSpaceLimit: A flag specifying whether the player storage 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.[StorageSpaceLimitUnit] StorageSpaceLimitUnits: A StorageSpaceLimitUnit enumeration specifying whether the following limits are measured in percentages or megabytes.[ushort] 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.[ushort] 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.[ushort] HtmlDataSizeLimit: The maximum size of the HTML application cache.[ushort] HtmlLocalStorageSizeLimit: The maximum size of all JavaScript variables and data.[List<Device>] Devices:(read only) A list of Device entities that are assigned to the current group.[PresentationInfo[]]Presentations:(read only) An array of PresentationInfo structures denoting presentations that are currently scheduled for the Group instance.
...
The StorageSpaceLimitUnit enumeration has the following values:
PercentageMegabyte
Group Management Web Methods
...
Retrieves the next page of the Group list, sorted by [string] Name. The returned list will contain no more items than the defined page size.
...
Group: View Groups
Parameters
[string] marker: The[string] Nameof of the last Group instance on the previous page. If the value is Null, then the method will retrieve the first page.[int] pageSize: The maximum number of objects returned by the method. If the list of objects that match the search criteria exceeds the[int] pageSizelimit limit, the returned list will indicate that it is truncated. If the integer is not positive, then the method will return the maximum allowed number of objects. Attempting to request more objects than is allowed will lead to the same result, but without an error.
...
Group: View Groups
Parameters
[int[]]groupIds: An array of[int] Idvalues values for the Group instances being requested. The number of returned items is limited to 100 by the server. Attempting to request more than the maximum allowed number of objects will cause an error, while passing an empty array will lead to an immediate empty response without an error.
...
Presentation: View Presentations
Parameters
[string] namePattern: The exact[string] Nameof of the Group instance (or its wildcard-based pattern). Supported wildcards currently include “*”, “?”, and “[‘and’]”.[string] marker: The[string] Nameof of the last Group instance on the previous page. If the value is Null, then the method will retrieve the first page.[int] pageSize: The maximum number of objects returned by the method. If the list of objects that match the search criteria exceeds the[int] pageSizelimit limit, the returned list will indicate that it is truncated. If the integer is not positive, then the method will return the maximum allowed number of objects. Attempting to request more objects than is allowed will lead to the same result, but without an error.
...
Retrieves a single Group instance with the specified [int] Id. This method returns Null if he Group instance with the specified identifier does not exist.
...
Group: View Groups
Parameters
[int] groupId: The identifier and primary key of the Group instance to be retrieved.[bool] loadDevices: A flag specifying whether the method should also initialize and return a list of all Device instances that are assigned to the specified Group.
...
Group: View Groups
Parameters
[string] name: The user-defined Name of the Group instance to be retrieved.[bool] loadDevices: A flag specifying whether the method should also initialize and return a list of all Device instances that are assigned to the specified Group.
...
Group: Create Group
Parameters
[Group] entity: A Group object instance with an initialized name, device autorun version, firmware versions, and debugging settings. Other property values will be ignored. If this parameter is set to Null, the method will immediately return False without an error. A descriptive error will be returned if any of the following conditions occur:- The length of the specified Group
[string] Nameis is greater than 50 characters. - The specified Group
[string] Nameis is already in use by another Group instance within the account. - Creating the Group instance will cause the total number of Group instances to exceed the limit set on the server.
- The length of the specified Group
...
Group: Update Group
Parameters
[BrightWallGroup] entity: A Group object instance specifying the[int] Idof of the Group instance to update, as well as other new properties for the updated instance:[string] HD9XXFirmware,[string] HDX10Firmware,[string] HDX20Firmware,[string] HDX22Firmware,[string] XDX30Firmware,[string] XDX32Firmware,[string] 4KX42Firmware,[bool] EnableSerialDebugging,[bool] EnableSystemLogDebugging,[StorageSpaceLimitUnit] StorageSpaceLimitUnits,[ushort] PublishedDataSizeLimit,[ushort] DynamicDataSizeLimit,[ushort] HtmlDataSizeLimit, and[ushort] HtmlLocalStorageSizeLimit. If this parameter is Null or Invalid, the method will immediately return Null without an error. A descriptive error will be returned if any of the following conditions occur.- The specified
[int] Iddoes does not correspond to an existing Group instance. - The
[string] Nameof of the Group entity does not correspond to the original instance (i.e. Group instances cannot be renamed using this method). - The sum of the the
[ushort] PublishedDataSizeLimit,[ushort] DynamicDataSizeLimit,[ushort] HtmlDataSizeLimit, and HtmlLocalStorageSizeLimit and[ushort] HtmlLocalStorageSizeLimitvalues does not equal 100 when the StorageSpaceLimitUnits enumeration is set to Percentage. - One of the specified model firmware versions is invalid or not supported. A firmware version value can be set to Null or left empty without error.
- The specified
...
Group: Update Group, Update Firmware
Parameters
[int[]]groupIds: An array of[int] Idvalues values specifying the Group instances to be updated. The maximum number of items is limited to 100 by the server. Attempting to request more than the maximum allowed number of objects will cause an error, while passing an empty array will lead to an immediate empty response without an error.[string] hdx10Firmware: A new value for the[string] HDX10Firmwareproperty property of the specified Group instance(s).[string] hdx20Firmware: A new value for the[string] HDX20Firmwareproperty property of the specified Group instance(s).[string] hdx22Firmware: A new value for the[string] HDX22Firmwareproperty property of the specified Group instance(s).[string] xdx30Firmware: A new value for the[string] XDX30Firmwareproperty property of the specified Group instance(s).[string] xdx32Firmware: A new value for the[string] XDX32Firmwareproperty property of the specified Group instance(s).[string] 4kx42Firmware: A new value for the[string] 4KX42Firmwareproperty property of the specified Group instance(s).
...
A descriptive error will be returned if any of the following conditions occur:
- One or more of the
[int] Idvalues values does not correspond to an existing Group instance. - One of the specified firmware versions is invalid or not supported. A firmware version value can be set to Null or left empty without error.
...
Group: Delete Group, Remove Device – Device: Change Target Group
Parameters
[int] groupId: The identifier of the Group instance to be deleted. If the[int] Idvalue value is negative, the method will immediately return False without an error. A descriptive error will be returned if the Group specified for deletion is reserved (i.e. the default “Unassigned” Group instance) or if the[int] Idvalue value is positive and does not correspond to an existing Group instance.[int] reassignmentGroupId: The identifier of the Group instance to which affected devices should be reassigned. If this value is negative, the devices will be reassigned to the default “Unassigned” Group instance. If a Group instance with the specified positive[int] Iddoes does not exist, the method will return a descriptive error.
...