add extended descriptions for default return values

Author: DocEmmetBrown

github/billing.go

@@ -65,16 +65,20 @@ type AdvancedSecurityCommittersBreakdown struct {
 
 // UsageReportOptions specifies optional parameters for the enhanced billing platform usage report.
 type UsageReportOptions struct {
-	// If specified, only return results for a single year. The value of year is an integer with four digits representing a year.
+	//If specified, only return results for a single year. The value of year is an integer with four digits representing a year. For example, 2025. Default value is the current year.
+
 	Year *int `url:"year,omitempty"`
 
-	// If specified, only return results for a single month. The value of month is an integer between 1 and 12.
+	// If specified, only return results for a single month. The value of month is an integer between 1 and 12. If no year is specified the default year is used.
+
 	Month *int `url:"month,omitempty"`
 
-	// If specified, only return results for a single day. The value of day is an integer between 1 and 31.
+	// If specified, only return results for a single day. The value of day is an integer between 1 and 31. If no year or month is specified, the default year and month are used.
+
 	Day *int `url:"day,omitempty"`
 
-	// If specified, only return results for a single hour. The value of hour is an integer between 0 and 23.
+	// If specified, only return results for a single hour. The value of hour is an integer between 0 and 23. If no year, month, or day is specified, the default year, month, and day are used.
+
 	Hour *int `url:"hour,omitempty"`
 }