feat: Add support for Copilot usage metrics reports API

github/copilot.go

@@ -185,6 +185,24 @@ type CopilotMetrics struct {
 	CopilotDotcomPullRequests *CopilotDotcomPullRequests `json:"copilot_dotcom_pull_requests,omitempty"`
 }
 
+// CopilotMetricsReportOptions specifies the optional parameters for single-day metrics report endpoints.
+type CopilotMetricsReportOptions struct {
+	Day string `url:"day"` // Required, format: YYYY-MM-DD
+}
+
+// CopilotMetricsDailyReportResponse represents the response from 1-day Copilot metrics report endpoints.
+type CopilotMetricsDailyReportResponse struct {
+	DownloadLinks []string `json:"download_links"`
+	ReportDay     string   `json:"report_day"`
+}
+
+// CopilotMetricsPeriodReportResponse represents the response from 28-day Copilot metrics report endpoints.
+type CopilotMetricsPeriodReportResponse struct {
+	DownloadLinks  []string `json:"download_links"`
+	ReportStartDay string   `json:"report_start_day"`
+	ReportEndDay   string   `json:"report_end_day"`
+}
+
 // UnmarshalJSON implements the json.Unmarshaler interface.
 func (cp *CopilotSeatDetails) UnmarshalJSON(data []byte) error {
 	// Using an alias to avoid infinite recursion when calling json.Unmarshal
@@ -574,3 +592,195 @@ func (s *CopilotService) GetOrganizationTeamMetrics(ctx context.Context, org, te
 
 	return metrics, resp, nil
 }
+
+// GetEnterpriseMetricsReport1Day gets a report containing Copilot metrics for a single day for an enterprise.
+//
+// GitHub API docs: https://docs.github.com/enterprise-cloud@latest/rest/copilot/copilot-usage-metrics#get-copilot-enterprise-usage-metrics-for-a-specific-day
+//
+//meta:operation GET /enterprises/{enterprise}/copilot/metrics/reports/enterprise-1-day
+func (s *CopilotService) GetEnterpriseMetricsReport1Day(ctx context.Context, enterprise string, opts *CopilotMetricsReportOptions) (*CopilotMetricsDailyReportResponse, *Response, error) {
+	u := fmt.Sprintf("enterprises/%v/copilot/metrics/reports/enterprise-1-day", enterprise)
+	u, err := addOptions(u, opts)
+	if err != nil {
+		return nil, nil, err
+	}
+
+	req, err := s.client.NewRequest("GET", u, nil)
+	if err != nil {
+		return nil, nil, err
+	}
+
+	var report *CopilotMetricsDailyReportResponse
+	resp, err := s.client.Do(ctx, req, &report)
+	if err != nil {
+		return nil, resp, err
+	}
+
+	return report, resp, nil
+}
+
+// GetEnterpriseMetricsReport28Day gets a report containing Copilot metrics for a 28-day rolling window for an enterprise.
+//
+// GitHub API docs: https://docs.github.com/enterprise-cloud@latest/rest/copilot/copilot-usage-metrics#get-copilot-enterprise-usage-metrics
+//
+//meta:operation GET /enterprises/{enterprise}/copilot/metrics/reports/enterprise-28-day/latest
+func (s *CopilotService) GetEnterpriseMetricsReport28Day(ctx context.Context, enterprise string) (*CopilotMetricsPeriodReportResponse, *Response, error) {
+	u := fmt.Sprintf("enterprises/%v/copilot/metrics/reports/enterprise-28-day/latest", enterprise)
+
+	req, err := s.client.NewRequest("GET", u, nil)
+	if err != nil {
+		return nil, nil, err
+	}
+
+	var report *CopilotMetricsPeriodReportResponse
+	resp, err := s.client.Do(ctx, req, &report)
+	if err != nil {
+		return nil, resp, err
+	}
+
+	return report, resp, nil
+}
+
+// GetEnterpriseMetricsReportUsers1Day gets a report containing Copilot user metrics for a single day for an enterprise.
+//
+// GitHub API docs: https://docs.github.com/enterprise-cloud@latest/rest/copilot/copilot-usage-metrics#get-copilot-users-usage-metrics-for-a-specific-day
+//
+//meta:operation GET /enterprises/{enterprise}/copilot/metrics/reports/users-1-day
+func (s *CopilotService) GetEnterpriseMetricsReportUsers1Day(ctx context.Context, enterprise string, opts *CopilotMetricsReportOptions) (*CopilotMetricsDailyReportResponse, *Response, error) {
+	u := fmt.Sprintf("enterprises/%v/copilot/metrics/reports/users-1-day", enterprise)
+	u, err := addOptions(u, opts)
+	if err != nil {
+		return nil, nil, err
+	}
+
+	req, err := s.client.NewRequest("GET", u, nil)
+	if err != nil {
+		return nil, nil, err
+	}
+
+	var report *CopilotMetricsDailyReportResponse
+	resp, err := s.client.Do(ctx, req, &report)
+	if err != nil {
+		return nil, resp, err
+	}
+
+	return report, resp, nil
+}
+
+// GetEnterpriseMetricsReportUsers28Day gets a report containing Copilot user metrics for a 28-day rolling window for an enterprise.
+//
+// GitHub API docs: https://docs.github.com/enterprise-cloud@latest/rest/copilot/copilot-usage-metrics#get-copilot-users-usage-metrics
+//
+//meta:operation GET /enterprises/{enterprise}/copilot/metrics/reports/users-28-day/latest
+func (s *CopilotService) GetEnterpriseMetricsReportUsers28Day(ctx context.Context, enterprise string) (*CopilotMetricsPeriodReportResponse, *Response, error) {
+	u := fmt.Sprintf("enterprises/%v/copilot/metrics/reports/users-28-day/latest", enterprise)
+
+	req, err := s.client.NewRequest("GET", u, nil)
+	if err != nil {
+		return nil, nil, err
+	}
+
+	var report *CopilotMetricsPeriodReportResponse
+	resp, err := s.client.Do(ctx, req, &report)
+	if err != nil {
+		return nil, resp, err
+	}
+
+	return report, resp, nil
+}
+
+// GetOrganizationMetricsReport1Day gets a report containing Copilot metrics for a single day for an organization.
+//
+// GitHub API docs: https://docs.github.com/enterprise-cloud@latest/rest/copilot/copilot-usage-metrics#get-copilot-organization-usage-metrics-for-a-specific-day
+//
+//meta:operation GET /orgs/{org}/copilot/metrics/reports/organization-1-day
+func (s *CopilotService) GetOrganizationMetricsReport1Day(ctx context.Context, org string, opts *CopilotMetricsReportOptions) (*CopilotMetricsDailyReportResponse, *Response, error) {
+	u := fmt.Sprintf("orgs/%v/copilot/metrics/reports/organization-1-day", org)
+	u, err := addOptions(u, opts)
+	if err != nil {
+		return nil, nil, err
+	}
+
+	req, err := s.client.NewRequest("GET", u, nil)
+	if err != nil {
+		return nil, nil, err
+	}
+
+	var report *CopilotMetricsDailyReportResponse
+	resp, err := s.client.Do(ctx, req, &report)
+	if err != nil {
+		return nil, resp, err
+	}
+
+	return report, resp, nil
+}
+
+// GetOrganizationMetricsReport28Day gets a report containing Copilot metrics for a 28-day rolling window for an organization.
+//
+// GitHub API docs: https://docs.github.com/enterprise-cloud@latest/rest/copilot/copilot-usage-metrics#get-copilot-organization-usage-metrics
+//
+//meta:operation GET /orgs/{org}/copilot/metrics/reports/organization-28-day/latest
+func (s *CopilotService) GetOrganizationMetricsReport28Day(ctx context.Context, org string) (*CopilotMetricsPeriodReportResponse, *Response, error) {
+	u := fmt.Sprintf("orgs/%v/copilot/metrics/reports/organization-28-day/latest", org)
+
+	req, err := s.client.NewRequest("GET", u, nil)
+	if err != nil {
+		return nil, nil, err
+	}
+
+	var report *CopilotMetricsPeriodReportResponse
+	resp, err := s.client.Do(ctx, req, &report)
+	if err != nil {
+		return nil, resp, err
+	}
+
+	return report, resp, nil
+}
+
+// GetOrganizationMetricsReportUsers1Day gets a report containing Copilot user metrics for a single day for an organization.
+//
+// GitHub API docs: https://docs.github.com/enterprise-cloud@latest/rest/copilot/copilot-usage-metrics#get-copilot-organization-users-usage-metrics-for-a-specific-day
+//
+//meta:operation GET /orgs/{org}/copilot/metrics/reports/users-1-day
+func (s *CopilotService) GetOrganizationMetricsReportUsers1Day(ctx context.Context, org string, opts *CopilotMetricsReportOptions) (*CopilotMetricsDailyReportResponse, *Response, error) {
+	u := fmt.Sprintf("orgs/%v/copilot/metrics/reports/users-1-day", org)
+	u, err := addOptions(u, opts)
+	if err != nil {
+		return nil, nil, err
+	}
+
+	req, err := s.client.NewRequest("GET", u, nil)
+	if err != nil {
+		return nil, nil, err
+	}
+
+	var report *CopilotMetricsDailyReportResponse
+	resp, err := s.client.Do(ctx, req, &report)
+	if err != nil {
+		return nil, resp, err
+	}
+
+	return report, resp, nil
+}
+
+// GetOrganizationMetricsReportUsers28Day gets a report containing Copilot user metrics for a 28-day rolling window for an organization.
+//
+// GitHub API docs: https://docs.github.com/enterprise-cloud@latest/rest/copilot/copilot-usage-metrics#get-copilot-organization-users-usage-metrics
+//
+//meta:operation GET /orgs/{org}/copilot/metrics/reports/users-28-day/latest
+func (s *CopilotService) GetOrganizationMetricsReportUsers28Day(ctx context.Context, org string) (*CopilotMetricsPeriodReportResponse, *Response, error) {
+	u := fmt.Sprintf("orgs/%v/copilot/metrics/reports/users-28-day/latest", org)
+
+	req, err := s.client.NewRequest("GET", u, nil)
+	if err != nil {
+		return nil, nil, err
+	}
+
+	var report *CopilotMetricsPeriodReportResponse
+	resp, err := s.client.Do(ctx, req, &report)
+	if err != nil {
+		return nil, resp, err
+	}
+
+	return report, resp, nil
+}