components/permissions/constants.h

   1 // Copyright 2021 The Chromium Authors
   2 // Use of this source code is governed by a BSD-style license that can be
   3 // found in the LICENSE file.
   4
   5 #ifndef COMPONENTS_PERMISSIONS_CONSTANTS_H_
   6 #define COMPONENTS_PERMISSIONS_CONSTANTS_H_
   7
   8 #include "base/component_export.h"
   9 #include "base/time/clock.h"
  10 #include "build/build_config.h"
  11
  12 namespace permissions {
  13
  14 // The URL for the Bluetooth Overview help center article in the Web Bluetooth
  15 // Chooser.
  16 COMPONENT_EXPORT(PERMISSIONS_COMMON)
  17 extern const char kChooserBluetoothOverviewURL[];
  18
  19 // The URL for the Embedded Content help center article in the SAA permission
  20 // prompt.
  21 COMPONENT_EXPORT(PERMISSIONS_COMMON)
  22 extern const char kEmbeddedContentHelpCenterURL[];
  23
  24 #if !BUILDFLAG(IS_ANDROID)
  25 // The key in `Product Specific String Data` under which the disposition of the
  26 // permission prompt is recorded in the prompt HaTS survey.
  27 COMPONENT_EXPORT(PERMISSIONS_COMMON)
  28 extern const char kPermissionsPromptSurveyPromptDispositionKey[];
  29
  30 // The key in `Product Specific String Data` under which the quiet UI reason is
  31 // recorded in the prompt HaTS survey.
  32 COMPONENT_EXPORT(PERMISSIONS_COMMON)
  33 extern const char kPermissionsPromptSurveyPromptDispositionReasonKey[];
  34
  35 // The key in `Product Specific String Data` under which the request action is
  36 // recorded in the prompt HaTS survey.
  37 COMPONENT_EXPORT(PERMISSIONS_COMMON)
  38 extern const char kPermissionsPromptSurveyActionKey[];
  39
  40 // The key in `Product Specific String Data` under which the request type is
  41 // recorded in the prompt HaTS survey.
  42 COMPONENT_EXPORT(PERMISSIONS_COMMON)
  43 extern const char kPermissionsPromptSurveyRequestTypeKey[];
  44
  45 // The key in `Product Specific String Data` under which the display timing of
  46 // the survey is recorded in the prompt HaTS survey.
  47 COMPONENT_EXPORT(PERMISSIONS_COMMON)
  48 extern const char kPermissionsPromptSurveyDisplayTimeKey[];
  49
  50 // The key in `Product Specific String Data` under which the 'one time prompts
  51 // decided' count bucket of the user taking the prompt HaTS survey is recorded.
  52 COMPONENT_EXPORT(PERMISSIONS_COMMON)
  53 extern const char kPermissionPromptSurveyOneTimePromptsDecidedBucketKey[];
  54
  55 // The key in `Product Specific String Data` under which the URL on which the
  56 // prompt HaTS survey was triggered is recorded.
  57 COMPONENT_EXPORT(PERMISSIONS_COMMON)
  58 extern const char kPermissionPromptSurveyUrlKey[];
  59
  60 // The key in `Product Specific Bits Data` under which whether the prompt was
  61 // triggered by a user gestured is recorded in the prompt HaTS survey.
  62 COMPONENT_EXPORT(PERMISSIONS_COMMON)
  63 extern const char kPermissionsPromptSurveyHadGestureKey[];
  64
  65 // The key in `Product Specific Bits Data` under which the release channel on
  66 // which the prompt was triggered is recorded in the prompt HaTS survey.
  67 // Note that a finch config typically defines a min_version to run the
  68 // experiment. When Version V is stable, Beta (V+1), Dev (V+2) and Canary (V+3)
  69 // all have higher version numbers and will therefore be part of the experiment
  70 // with min_version V with the rollout plan for stable. This filter allows
  71 // restriction to specific channels (typically to stable).
  72 COMPONENT_EXPORT(PERMISSIONS_COMMON)
  73 extern const char kPermissionsPromptSurveyReleaseChannelKey[];
  74 #endif
  75
  76 // TODO(crbug.com/1410489): Remove the code related to unused site permissions
  77 // from Android builds.
  78
  79 // The key used for marking permissions as revoked, as per the unused site
  80 // permissions module of Safety Check.
  81 COMPONENT_EXPORT(PERMISSIONS_COMMON)
  82 extern const char kRevokedKey[];
  83
  84 }  // namespace permissions
  85
  86 #endif  // COMPONENTS_PERMISSIONS_CONSTANTS_H_