Implement permission embargo suppression metrics.

chrome/browser/permissions/permission_util.h

 // Copyright 2015 The Chromium Authors. All rights reserved.
 // Use of this source code is governed by a BSD-style license that can be
 // found in the LICENSE file.
 
 #ifndef CHROME_BROWSER_PERMISSIONS_PERMISSION_UTIL_H_
 #define CHROME_BROWSER_PERMISSIONS_PERMISSION_UTIL_H_
 
 #include <string>
 
 #include "base/macros.h"
@@ skipping 17 matching lines @@
   DISMISSED = 2,
   IGNORED = 3,
   REVOKED = 4,
   REENABLED = 5,
   REQUESTED = 6,
 
   // Always keep this at the end.
   PERMISSION_ACTION_NUM,
 };
 
+// Identifies the source or reason for a permission status being returned. This
+// enum backs an UMA histogram and must be treated as append-only.
+enum class PermissionStatusSource {
+  // The reason for the status is not specified.
+  UNSPECIFIED,
+
+  // The status is the result of being blocked due to the user dismissing a
+  // permission prompt multiple times.
+  MULTIPLE_DISMISSALS,
+
+  // The status is the result of being blocked because the permission is on the
+  // safe browsing blacklist.
+  SAFE_BROWSING_BLACKLIST,
+
+  // The status is the result of being blocked by the permissions kill switch.
+  KILL_SWITCH,
+};
+
+struct PermissionResult {
+  PermissionResult(ContentSetting content_setting,
+                   PermissionStatusSource source);
+  ~PermissionResult();
+
+  ContentSetting content_setting;
+  PermissionStatusSource source;
+};
+
 // A utility class for permissions.
 class PermissionUtil {
  public:
   // Returns the permission string for the given permission.
   static std::string GetPermissionString(ContentSettingsType);
 
   // Return the stringified version of the ContentSettingsType enum that
   // Safe Browsing uses for the API Blacklist.
   static std::string ConvertContentSettingsTypeToSafeBrowsingName(
       ContentSettingsType permission);
@@ skipping 41 matching lines @@
     ContentSettingsType content_type_;
     PermissionSourceUI source_ui_;
     bool is_initially_allowed_;
   };
 
  private:
   DISALLOW_IMPLICIT_CONSTRUCTORS(PermissionUtil);
 };
 
 #endif  // CHROME_BROWSER_PERMISSIONS_PERMISSION_UTIL_H_