Adding an experimental app notification API.

chrome/common/extensions/api/extension_api.json

 [
   {
     "namespace": "extension",
     "unprivileged": true,
     "types": [
       {
         "id": "MessageSender",
         "type": "object",
         "description": "An object containing information about the script context that sent a message or request.",
         "properties": {
@@ skipping 6152 matching lines @@
         "description": "Fired when browser terminates debugging session for the tab.",
         "parameters": [
           {
             "type": "integer",
             "name": "tabId",
             "description": "The id of the tab that was detached."
           }
         ]
       }
     ]
+  },
+  {
+    "namespace":"experimental.app",
+    "functions": [
+      {
+        "name": "notify",
+        "type": "function",
+        "description": "Creates a notification from this app.",
+        "parameters": [
+          {
+            "type": "object",
+            "name": "details",
+            "properties": {
+              "passive": {
+                "type": "boolean",
+                "optional": "true",
+                "description": "Whether the notification should be passive (true) or active (false). The default value is true."
+              },
+              "title": {
+                "type": "string",
+                "optional": true,
+                "description": "The title of the notification."  
+              },
+              "bodyText": {
+                "type": "string",
+                "optional": true,
+                "description": "The text content of the notification."
+              },
+              "linkUrl": {
+                "type": "string",
+                "optional": true,
+                "description": "The URL for an optional link to show along with the notification. If you specify a linkUrl, you must also specify a value for linkText."
+              },
+              "linkText": {
+                "type": "string",
+                "optional": true,
+                "description": "If a linkUrl is provided, this is required and will be used as the linkified text. It should be relatively short."
+              },
+              "iconData": {
+                "type": "object",
+                "isInstanceOf": "ImageData",
+                "optional": true,
+                "properties": {},
+                "additionalProperties": { "type": "any" },
+                "description": "Pixel data for an image to use as the icon for this notification. Must be an ImageData object (for example, from a canvas element)."
+              }
+            }
+          },
+          {
+            "type": "function",
+            "name": "callback",
+            "optional": true,
+            "parameters": [],
+            "description": "A callback when the function is complete. Any errors will be reported in <a href='extension.html#property-lastError'>chrome.extension.lastError</a>."
+          }
+        ]
+      },
+      {
+        "name": "clearAllNotifications",
+        "type": "function",
+        "description": "Clears all previously sent notifications.",
+        "parameters": [
+          {
+            "type": "function",
+            "name": "callback",
+            "optional": true,
+            "description": "A callback when the function is complete. Any errors will be reported in <a href='extension.html#property-lastError'>chrome.extension.lastError</a>."
+          }
+        ]
+      },
+      {
+        "name": "setLaunchIcon",
+        "type": "function",
+        "parameters": [
+          {
+            "type": "object",
+            "name": "iconData",
+            "isInstanceOf": "ImageData",
+            "optional": true,
+            "properties": {},
+            "additionalProperties": { "type": "any" },
+            "description": "Pixel data for an image to replace the launch icon on the New Tab Page. Must be an ImageData object (for example, from a canvas element). See http://code.google.com/chrome/webstore/docs/images.html for more details."
+          },
+          {
+            "type": "function",
+            "name": "callback",
+            "optional": true,
+            "description": "A callback when the function is complete. Any errors will be reported in <a href='extension.html#property-lastError'>chrome.extension.lastError</a>."
+          }
+        ]
+      },
+      {
+        "name": "resetLaunchIcon",
+        "type": "function",
+        "description": "Resets the app's launch icon to its default value as specified in the manifest.json file.",
+        "parameters": [
+          {
+            "type": "function",
+            "name": "callback",
+            "optional": true,
+            "description": "A callback when the function is complete. Any errors will be reported in <a href='extension.html#property-lastError'>chrome.extension.lastError</a>."
+          }
+        ]
+      }
+    ]
   }
 ]