Notifications
  • 07 May 2024

Notifications


Article summary

Notifications

Introduction

Notification rules can be set up to automatically send targeted information about certain events. For example, you can send an email to any address when an automatic video release expires. You can define the date of the notification as well as the addressee.

Create a Notification Rule

1. Select the "Notifications" entry in the navigation pane.

2. Click the [Create] button.

3. Select an event and action from the drop-down menus.

Event

Description

Timed video release will expire

As soon as a timed video release expires, the configured action is triggered.

Video uploaded

As soon as a new video is uploaded to your account, the configured action is triggered.

Video changed

The configured action is triggered as soon as a video is changed in one of the following ways:

  • metadata (e.g. title, description, keywords, etc.)

  • security settings (e.g. release status, security policy, etc.)

  • moving a video to the trash or restoring a deleted video

  • a video has been replaced

  • a video was assigned to a channel or unlinked from a channel

Channel changed

The configured action is triggered as soon as a channel changes in one of the following ways:

  • a new channel was created

  • a channel was deleted

  • a channel name has been changed

  • the owner group of a channel has been changed.

Monthly report

At the end of each month (last day of a calendar month), a monthly report is sent to the specified e-mail addresses. The following information is available in this report:

  • traffic generated by each group

  • storage used by each group

Social media publication

The configured action is triggered as soon as a video publish to a social media profile is initiated, such as YouTube.

3. Select one of the following "Action" options from the drop-down menu:

Event

Description

Send email to address

When the selected event occurs, an email will be sent to the registered email address.
You can also set the language of the notification (see step 4).

Call up URL with GET

When the selected event occurs, the specified URL will be called up. API developers can use this to trigger events within their own API.

Call up URL with POST

When the selected event occurs, information regarding the selected event is passed in a JSON-file to the specified URL. API developers can use this data within their own API. Each POST will send an event object containing some standard data and some values specific to the type of event. Use the list below to reveal a sample response for each event type:

 Timed video release will expire...

{

    "videoManagerId": 174,

    "videoManagerName": "Company Videos",

    "eventExecutionTime": 1466422467227,

    "eventType": "PUBLISH_PERIOD_EXPIRES",

    "videoId": "CPfMCAuS5U78C4eshAaBWV",

    "periodEnd": 1417089466985,

    "editorEmail": ""

}

 Video uploaded...

{

    "videoManagerId": 174,

    "videoManagerName": "Company Videos",

    "eventExecutionTime": 1466422467227,

    "eventType": "VIDEO_UPLOADED",

    "videoId": "CPfMCAuS5U78C4eshAaBWV",

    "fileName": "video.mp4",

    "editorEmail": "example@movingimage.com"

}

 Video changed...

{

    "videoManagerId": 174,

    "videoManagerName": "Company Videos",

    "eventExecutionTime": 1466422467227,

    "eventType": "VIDEO_CHANGED",

    "videoId": "CPfMCAuS5U78C4eshAaBWV",

    "fields": ["TITLE","DESCRIPTION"],

    "editorEmail": ""

}

 Channel changed...

{

    "videoManagerId": 174,

    "videoManagerName": "Company Videos",

    "eventExecutionTime": 1466422467227,

    "eventType": "CHANNEL_CHANGED",

    "changeType": "VIDEOS_ADDED",

    "channelId": 54,

    "channelName": "Promo",

    "videoIds": ["CPfMCAuS5U78C4eshAaBWV","7PfMCAuS5U78C4eshAaBWV"],

    "editorEmail": ""

}

 Monthly report...

{

    "trafficBooked": 500,

    "monthTraffic": 8.270144462585449e-7,

    "storageAllotment": 500,

    "storageUsed": 345,

    "groupTraffic": [

        {

            "id": 1,

            "name": "Company",

            "traffic": 2.0675361156463623e-7,

            "storage": 22

        },

        {

            "id": 2,

            "name": "Marketing",

            "traffic": 2.0675361156463623e-7,

            "storage": 33

        },

        {

            "id": 3,

            "name": "Documentation",

            "traffic": 4.1350722312927246e-7,

            "storage": 55

        }

    ],

    "editorEmail": ""

}

 Social media publish...

{

    "videoManagerId": 174,

    "videoManagerName": "Company Videos",

    "eventExecutionTime": 1503589879686,

    "eventType": "SOCIAL_MEDIA_PUBLISH",

    "videoId": "CPfMCAuS5U78C4eshAaBWV",

    "socialMediaType": "YOUTUBE",

    "publicationProfileName": "Company YouTube Profile",

    "editorEmail": "example@movingimage.com"

}

Note that the "editorEmail" will return an empty string unless the "User Email" toggle in the "Include User Information" field is enabled (it defaults to off). The "editorEmail" string will also always be empty for certain event types that aren't initiated by a user (e.g. monthly reports).

  1. If you have selected an email notification, you can choose the language for this notification in the drop-down menu.

  2. Click the [Create] button to create the notification rule and display it in the list.

Edit a notification rule

To activate a newly created notification rule, you must first configure the options in the rule's edit pane.

  1. Click a rule from the notifications list to open the edit pane for that rule.

    If a gray [] icon is displayed to the right of a notification rule, this indicates that it is not yet activated.

  2. Enter the following configurations:

    Parameter

    Description

    Type

    The notification type is automatically entered by the system and cannot not be edited. It consists of the selected event and the action.

    Name

    Optional. Enter the desired name for the notification rule in the text box provided for this purpose.

    Notification time

    This field will appear if "Timed video release will expire" is the selected event type. Use this field to enter the desired time for the notification (in days before the occurrence of the event). By default, the value is set to 14 days.

    Email

    This field will appear if "Send email to address" is the selected action type. Use this field to specify a valid e-mail address to send this notification to.

    It is possible to set up multiple email addresses to receive the notification. The [Add email] button will appear after activating the notification (see step 3 below). Click the button to create another text field, allowing you to enter more e-mail addresses.

    Include User Information

    This field will appear if the "Call up URL with POST" action is selected. You can switch the "User Email" toggle on to include the user's email address in the POST data (under the "editorEmail" key). When the toggle is off, an empty string will be sent in the POST data instead. The default state is off.

    In some cases, even when the "User Email" toggle is on, the "editorEmail" value will still be an empty string. This happens when event types that aren't initiated by a user trigger the action (i.e. the monthly report and timed video release will expire events).

    URL

    This field will appear if one of the "Call up URL..." actions is the selected. Use this field to specify the URL to call up when the selected event occurs.

    It is possible to set up multiple URLs. The [Add URL] button will appear after activating the notification (see step 3 below). Click the button to create another text field, allowing you to enter an additional URL.

  3. Finally, click the [Activate] button to enable the notification rule.


Was this article helpful?

What's Next