Updated code comment strings.

PiperOrigin-RevId: 888233096

Author: Nicholas Ventimiglia

source/plugin/Assets/GoogleMobileAds/Api/AdError.cs

@@ -54,18 +54,18 @@ public string GetDomain()
 
         /// <summary>
         /// Returns the error message.
-        /// <seealso href="https://support.google.com/admob/answer/9905175"/>
+        /// <a href="https://support.google.com/admob/answer/9905175">https://support.google.com/admob/answer/9905175</a>
         /// for explanations of common errors.
-        /// <summary>
+        /// </summary>
         /// <returns>Ad Error Message. </returns>
         public string GetMessage()
         {
             return _client.GetMessage();
         }
 
-        ///<summary>
-        /// Returns the cause of this error or <c>null</c> if the cause is nonexistent or unknown.
         /// <summary>
+        /// Returns the cause of this error or <c>null</c> if the cause is nonexistent or unknown.
+        /// </summary>
         /// <returns>Returns the cause of this error.</returns>
         public AdError GetCause()
         {

source/plugin/Assets/GoogleMobileAds/Api/AdInspectorError.cs

@@ -18,34 +18,44 @@ namespace GoogleMobileAds.Api {
 
   /// <summary>
   /// Error information about why the ad inspector failed.
-  /// <summary>
+  /// </summary>
   public class AdInspectorError : AdError {
 
         /// <summary>
         /// Error information about why the ad inspector failed.
-        /// <summary>
+        /// </summary>
         public enum AdInspectorErrorCode {
           /// <summary>
           /// Ad inspector had an internal error.
-          /// <summary>
+          /// </summary>
           ERROR_CODE_INTERNAL_ERROR = 0,
           /// <summary>
           /// Ad inspector failed to load.
-          /// <summary>
+          /// </summary>
           ERROR_CODE_FAILED_TO_LOAD = 1,
           /// <summary>
           /// Ad inspector cannot be opened because the device is not in test mode.
           /// information.
-          /// <summary>
+          /// </summary>
           ERROR_CODE_NOT_IN_TEST_MODE = 2,
           /// <summary>
           /// Ad inspector cannot be opened because it is already open.
-          /// <summary>
+          /// </summary>
           ERROR_CODE_ALREADY_OPEN = 3
         }
 
+    /// <summary>
+    /// Creates an <see cref="AdInspectorError"/>.
+    /// </summary>
+    /// <param name="client">
+    /// A platform level <see cref="IAdInspectorErrorClient"/> implementation.
+    /// </param>
     public AdInspectorError(IAdInspectorErrorClient client) : base(client) {}
 
+    /// <summary>
+    /// Returns the error code.
+    /// </summary>
+    /// <returns>The error code.</returns>
     public new AdInspectorErrorCode GetCode() {
       return (AdInspectorErrorCode)base.GetCode();
     }

source/plugin/Assets/GoogleMobileAds/Api/AdapterResponseInfo.cs

@@ -24,6 +24,12 @@ public class AdapterResponseInfo
     {
         private IAdapterResponseInfoClient _client;
 
+        /// <summary>
+        /// Creates an <see cref="AdapterResponseInfo"/>.
+        /// </summary>
+        /// <param name="client">
+        /// A platform level <see cref="IAdapterResponseInfoClient"/> implementation.
+        /// </param>
         public AdapterResponseInfo(IAdapterResponseInfoClient client)
         {
             _client = client;

source/plugin/Assets/GoogleMobileAds/Api/Core/AdRequest.cs

@@ -35,7 +35,7 @@ public class AdRequest
 
         /// <summary>
         /// Test device ID used to load test ads.
-        /// <seealso href="https://developers.google.com/admob/unity/test-ads"/>.
+        /// <a href="https://developers.google.com/admob/unity/test-ads">https://developers.google.com/admob/unity/test-ads</a>.
         /// </summary>
         public const string TestDeviceSimulator = "SIMULATOR";
 
@@ -52,6 +52,10 @@ static AdRequest()
 
         public AdRequest() {}
 
+        /// <summary>
+        /// Creates an <see cref="AdRequest"/> from a given <see cref="AdRequest"/>.
+        /// </summary>
+        /// <param name="request">The <see cref="AdRequest"/> parameter to copy.</param>
         public AdRequest(AdRequest request)
         {
             Keywords = request.Keywords;

source/plugin/Assets/GoogleMobileAds/Api/Core/AdSize.cs

@@ -81,6 +81,9 @@ public enum Type
         [System.Obsolete("Deprecated. Use AnchoredAdaptive.")]
         public static readonly AdSize SmartBanner = new AdSize(0, 0, Type.SmartBanner);
 
+        /// <summary>
+        /// The full width banner size.
+        /// </summary>
         public static readonly int FullWidth = -1;
 
         /// <summary>
@@ -108,16 +111,31 @@ private static AdSize CreateAnchoredAdaptiveAdSize(int width, Orientation orient
             return adSize;
         }
 
+        /// <summary>
+        /// Gets a landscape adaptive banner ad size.
+        /// </summary>
+        /// <param name="width">The width of the ad in density-independent pixels.</param>
+        /// <returns>A landscape adaptive banner ad size.</returns>
         public static AdSize GetLandscapeAnchoredAdaptiveBannerAdSizeWithWidth(int width)
         {
             return CreateAnchoredAdaptiveAdSize(width, Orientation.Landscape);
         }
 
+        /// <summary>
+        /// Gets a portrait adaptive banner ad size.
+        /// </summary>
+        /// <param name="width">The width of the ad in density-independent pixels.</param>
+        /// <returns>A portrait adaptive banner ad size.</returns>
         public static AdSize GetPortraitAnchoredAdaptiveBannerAdSizeWithWidth(int width)
         {
             return CreateAnchoredAdaptiveAdSize(width, Orientation.Portrait);
         }
 
+        /// <summary>
+        /// Gets a current orientation adaptive banner ad size.
+        /// </summary>
+        /// <param name="width">The width of the ad in density-independent pixels.</param>
+        /// <returns>A current orientation adaptive banner ad size.</returns>
         public static AdSize GetCurrentOrientationAnchoredAdaptiveBannerAdSizeWithWidth(int width)
         {
             return CreateAnchoredAdaptiveAdSize(width, Orientation.Current);
@@ -167,6 +185,9 @@ internal Orientation Orientation
             }
         }
 
+        /// <summary>
+        /// Returns whether the <see cref="AdSize"/> objects are equal.
+        /// </summary>
         public override bool Equals(object obj)
         {
             if (obj == null || GetType() != obj.GetType())
@@ -179,6 +200,12 @@ public override bool Equals(object obj)
             && (_type == other._type) && (_orientation == other._orientation);
         }
 
+        /// <summary>
+        /// Returns whether the <see cref="AdSize"/> objects are equal.
+        /// </summary>
+        /// <param name="a">The first <see cref="AdSize"/> object.</param>
+        /// <param name="b">The second <see cref="AdSize"/> object.</param>
+        /// <returns>True if the <see cref="AdSize"/> objects are equal.</returns>
         public static bool operator ==(AdSize a, AdSize b)
         {
             if ((object)a == null)
@@ -189,6 +216,12 @@ public override bool Equals(object obj)
             return a.Equals(b);
         }
 
+        /// <summary>
+        /// Returns whether the <see cref="AdSize"/> objects are not equal.
+        /// </summary>
+        /// <param name="a">The first <see cref="AdSize"/> object.</param>
+        /// <param name="b">The second <see cref="AdSize"/> object.</param>
+        /// <returns>True if the <see cref="AdSize"/> objects are not equal.</returns>
         public static bool operator !=(AdSize a, AdSize b)
         {
             if ((object)a == null)
@@ -199,6 +232,9 @@ public override bool Equals(object obj)
             return !a.Equals(b);
         }
 
+        /// <summary>
+        /// Returns the hash code.
+        /// </summary>
         public override int GetHashCode()
         {
             int hashBase = 71;

source/plugin/Assets/GoogleMobileAds/Api/Core/NativeTemplateStyle.cs

@@ -43,36 +43,43 @@ public class NativeTemplateStyle
     public string TemplateId;
 
     /// <summary>
-    // The background color.
+    /// The background color.
     /// </summary>
     public Color MainBackgroundColor;
 
     /// <summary>
-    // The NativeTemplateTextStyle for the primary text.
+    /// The NativeTemplateTextStyle for the primary text.
     /// </summary>
     public NativeTemplateTextStyle PrimaryText;
 
     /// <summary>
     /// The NativeTemplateTextStyle for the second row of text in the template.
-    /// <summary>
+    /// </summary>
     public NativeTemplateTextStyle SecondaryText;
 
     /// <summary>
     /// The NativeTemplateTextStyle for the third row of text in the template.
-    /// <summary>
+    /// </summary>
     public NativeTemplateTextStyle TertiaryText;
 
     /// <summary>
     /// The NativeTemplateTextStyle for the call to action.
-    /// <summary>
+    /// </summary>
     public NativeTemplateTextStyle CallToActionText;
 
+    /// <summary>
+    /// Creates a <see cref="NativeTemplateStyle"/> using the Small Template<see cref="TemplateId"/>.
+    /// </summary>
     public NativeTemplateStyle()
     {
       // Default to using the small template.
       TemplateId = NativeTemplateId.Small;
     }
 
+    /// <summary>
+    /// Creates a <see cref="NativeTemplateStyle"/> from a given <see cref="NativeTemplateStyle"/>.
+    /// </summary>
+    /// <param name="templateStyle">The <see cref="NativeTemplateStyle"/> parameter to copy.</param>
     public NativeTemplateStyle(NativeTemplateStyle templateStyle)
     {
       TemplateId = templateStyle.TemplateId;

source/plugin/Assets/GoogleMobileAds/Api/Core/PreloadConfiguration.cs

@@ -45,6 +45,10 @@ public sealed class PreloadConfiguration
 
         public PreloadConfiguration() { }
 
+        /// <summary>
+        /// Creates a <see cref="PreloadConfiguration"/> from a given <see cref="PreloadConfiguration"/>.
+        /// </summary>
+        /// <param name="configuration">The <see cref="PreloadConfiguration"/> parameter to copy.</param>
         public PreloadConfiguration(PreloadConfiguration configuration)
         {
             AdUnitId = configuration.AdUnitId;

source/plugin/Assets/GoogleMobileAds/Api/Core/RequestConfiguration.cs

@@ -32,8 +32,8 @@ public class RequestConfiguration
         /// <summary>
         /// This property allows you to specify whether you would like your app to be treated as
         /// child-directed for purposes of the Children’s Online Privacy Protection Act (COPPA) -
-        /// <seealso href="http://business.ftc.gov/privacy-and-security/childrens-privacy">
-        /// http://business.ftc.gov/privacy-and-security/childrens-privacy</seealso>.
+        /// <a href="http://business.ftc.gov/privacy-and-security/childrens-privacy">
+        /// http://business.ftc.gov/privacy-and-security/childrens-privacy</a>.
         ///
         /// If you set this property to True, you will
         /// indicate that your app should be treated as child-directed for purposes of the Children’s
@@ -50,7 +50,7 @@ public class RequestConfiguration
         /// authorized to act on behalf of the owner of the app. You understand that abuse of this
         /// setting may result in termination of your Google account.
         /// </summary>
-        /// </remarks>
+        /// <remarks>
         /// Note: it may take some time for this designation to be fully implemented in applicable
         /// Google services.
         /// </remarks>
@@ -83,6 +83,10 @@ public class RequestConfiguration
 
         public RequestConfiguration() {}
 
+        /// <summary>
+        /// Creates a <see cref="RequestConfiguration"/> from a given <see cref="RequestConfiguration"/>.
+        /// </summary>
+        /// <param name="requestConfiguration">The <see cref="RequestConfiguration"/> parameter to copy.</param>
         public RequestConfiguration(RequestConfiguration requestConfiguration)
         {
             MaxAdContentRating = requestConfiguration.MaxAdContentRating;

source/plugin/Assets/GoogleMobileAds/Api/Core/Reward.cs

@@ -35,6 +35,10 @@ public class Reward : EventArgs
 
         public Reward() {}
 
+        /// <summary>
+        /// Creates a <see cref="Reward"/> from a given <see cref="Reward"/>.
+        /// </summary>
+        /// <param name="reward">The <see cref="Reward"/> parameter to copy.</param>
         public Reward(Reward reward)
         {
             Type = reward.Type;

source/plugin/Assets/GoogleMobileAds/Api/Core/ServerSideVerificationOptions.cs

@@ -35,6 +35,10 @@ public class ServerSideVerificationOptions
 
         public ServerSideVerificationOptions() {}
 
+        /// <summary>
+        /// Creates a <see cref="ServerSideVerificationOptions"/> from a given <see cref="ServerSideVerificationOptions"/>.
+        /// </summary>
+        /// <param name="options">The <see cref="ServerSideVerificationOptions"/> parameter to copy.</param>
         public ServerSideVerificationOptions(ServerSideVerificationOptions options)
         {
             UserId = options.UserId;