Changes in version 2025-03-25                      

  - cross-ref issues + lazy data

                     Changes in version 2016-11-08                      

  - passes expect_lint_free
  - add more args to get_report, plus defaults for args.

  - initial release

                 Changes in version 0.5.0 (2026-04-12)                  

Modernization & Code Quality

  - NEW: Added checkmate dependency for robust parameter validation
  - NEW: Added rlang dependency for modern error handling with abort()
    and structured error classes
  - NEW: Retry logic for transient API failures with exponential backoff
  - NEW: Mock-based test suite that runs without API credentials
  - NEW: Comprehensive test coverage for validation, error handling, and
    data transformation

Major Usability Enhancements

  - NEW: Pre-built report functions for common analytics tasks:
    
      - get_channel_overview() - Comprehensive channel performance
        metrics
      - get_top_videos() - Best performing videos with sorting
      - get_audience_demographics() - Age/gender audience breakdown
      - get_geographic_performance() - Performance by country/region
      - get_daily_performance() - Time series data for trend analysis
      - get_revenue_report() - Monetization metrics (requires monetary
        scope)

  - NEW: Smart date handling with relative dates:
    
      - Support for intuitive dates: "last_30_days", "this_month",
        "yesterday", etc.
      - resolve_date_range() function for date calculations
      - get_common_date_ranges() to discover available options

  - NEW: Enhanced parameter validation:
    
      - get_available_metrics() and get_available_dimensions() for
        discovery
      - Smart error messages with typo suggestions (e.g., "vews" →
        "views")
      - Comprehensive validation for filters, dimensions, and
        requirements

  - NEW: Data transformation and export utilities:
    
      - yt_to_dataframe() - Convert API responses to clean data.frames
      - yt_to_tibble() - Modern tibble support
      - yt_export_csv() - Easy CSV export with automatic naming
      - yt_extract_summary() - Statistical summaries
      - yt_quick_plot() - One-line visualizations

  - NEW: Improved authentication and diagnostics:
    
      - Interactive OAuth setup guide for first-time users
      - diagnose_tubern() - Complete system health check
      - check_api_quota() - API usage monitoring
      - Better error messages and recovery suggestions

Breaking Changes

  - Removed test functions from package exports (internal use only)
  - Enhanced get_report() with additional parameter validation

Bug Fixes

  - Fixed date parsing issues in quarter calculations
  - Resolved duplicate documentation for internal functions
  - Fixed non-ASCII characters for CRAN compliance
  - Improved error handling throughout the package

                        Changes in version 0.3.0                        

Major API Updates

  - BREAKING: Updated to YouTube Analytics API v2 from deprecated v1
  - BREAKING: Changed base URL from youtube/analytics/v1 to
    youtubeanalytics.googleapis.com/v2
  - BREAKING: Updated API parameter names to match v2 specification:
      - start-date → startDate
      - end-date → endDate
      - max-results → maxResults
      - start-index → startIndex
      - include-historical-channel-data → includeHistoricalChannelData

Authentication Improvements

  - Added required youtube.readonly scope to OAuth authentication
  - Updated OAuth scopes to match current API requirements
  - Fixed authentication for both analytics and monetary-analytics
    scopes

Function Updates

  - get_report(): Fixed parameter mapping and improved documentation
  - list_groups(): Enhanced parameter handling and examples
  - add_groups(): Updated documentation with correct examples
  - All functions: Updated API references to v2 documentation

Documentation

  - Comprehensive README rewrite with examples and setup instructions
  - Added authentication setup guide
  - Documented available metrics and dimensions
  - Added API rate limiting information
  - Updated all function references to point to v2 API documentation

Bug Fixes

  - Fixed test token file path issues
  - Improved lintr test robustness
  - Enhanced error handling for package detection