Implementation of translation event logging.

components/translate/core/browser/translate_client.h

 // Copyright 2014 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 COMPONENTS_TRANSLATE_CORE_BROWSER_TRANSLATE_CLIENT_H_
 #define COMPONENTS_TRANSLATE_CORE_BROWSER_TRANSLATE_CLIENT_H_
 
 #include <memory>
 #include <string>
 
 #include "base/memory/ref_counted.h"
 #include "components/translate/core/browser/translate_prefs.h"
 #include "components/translate/core/browser/translate_step.h"
 #include "components/translate/core/common/translate_errors.h"
 
 class GURL;
 class PrefService;
 
 namespace infobars {
 class InfoBar;
 }
 
+namespace metrics {
+class TranslateEventProto;
+}  // namespace metrics
+
 namespace translate {
 
 class TranslateAcceptLanguages;
 class TranslateDriver;
 class TranslateInfoBarDelegate;
 
 // A client interface that needs to be supplied to TranslateManager by the
 // embedder.
 //
 // Each client instance is associated with a given context within which a
@@ skipping 10 matching lines @@
 
   // Returns the associated TranslatePrefs.
   virtual std::unique_ptr<TranslatePrefs> GetTranslatePrefs() = 0;
 
   // Returns the associated TranslateAcceptLanguages.
   virtual TranslateAcceptLanguages* GetTranslateAcceptLanguages() = 0;
 
   // Returns the resource ID of the icon to be shown for the Translate infobars.
   virtual int GetInfobarIconID() const = 0;
 
+  // Record translate event.
+  // This is for gaia-keyed logging.

[amoylan, 2017/05/30 03:10:56]

Is 'gaia' the right terminology to use in the context of a Chromium
//components?

[renjieliu1, 2017/05/30 03:33:24]

thanks for pointing out this!

+  virtual void RecordTranslateEvent(const metrics::TranslateEventProto&) = 0;

[amoylan, 2017/05/30 03:10:56]

Include name of the parameter to RecordTranslateEvent in this declaration, since
this parameter is not an unused parameter.

[renjieliu1, 2017/05/30 03:33:24]

Done.

+
 #if !defined(USE_AURA)
   // Returns a translate infobar that owns |delegate|.
   virtual std::unique_ptr<infobars::InfoBar> CreateInfoBar(
       std::unique_ptr<TranslateInfoBarDelegate> delegate) const = 0;
 #endif
 
   // Called when the embedder should present UI to the user corresponding to the
   // user's current |step|.
   virtual void ShowTranslateUI(translate::TranslateStep step,
                                const std::string& source_language,
                                const std::string& target_language,
                                TranslateErrors::Type error_type,
                                bool triggered_from_menu) = 0;
 
   // Returns true if the URL can be translated.
   virtual bool IsTranslatableURL(const GURL& url) = 0;
 
   // Presents |report_url|, a URL containing information relating to reporting
   // a language detection error, to the user to allow them to report language
   // detection errors as desired.
   virtual void ShowReportLanguageDetectionErrorUI(const GURL& report_url) = 0;
 };
 
 }  // namespace translate
 
 #endif  // COMPONENTS_TRANSLATE_CORE_BROWSER_TRANSLATE_CLIENT_H_