net3000.google 1.0.1

Net3000.Google

Overview

The Net3000.Google library provides comprehensive integration with various Google APIs for Net3000 solutions. This library enables Google Analytics data retrieval, Search Console integration, YouTube API access, Google Maps functionality, and other Google services.

Features

• Google Analytics: Retrieve analytics data and statistics
• Search Console: Access search performance data
• YouTube Integration: Manage YouTube content and analytics
• Google Maps: Places API integration and location services
• Authentication: OAuth2 and service account authentication
• Data Processing: Comprehensive data models and response handling

Installation

dotnet add package net3000.google

Dependencies

• net3000.common (v9.0.11)
• Google.Api.CommonProtos (v2.17.0)
• Google.Api.Gax (v4.11.1)
• Google.Api.Gax.Grpc (v4.11.1)
• Google.Apis (v1.71.0)
• Google.Apis.Auth (v1.71.0)
• Google.Apis.Core (v1.71.0)
• Google.Apis.SearchConsole.v1 (v1.70.0.3847)
• Google.Analytics.Data.V1Beta (v2.0.0-beta09)
• Google.Apis.MapsPlaces.v1 (v1.70.0.3874)
• Google.Apis.YouTube.v3 (v1.70.0.3847)
• Google.Geo.Type (v1.2.0)
• Google.Maps.Places.V1 (v1.0.0-beta08)
• Microsoft.Extensions.Configuration (v9.0.9)
• Selenium.WebDriver (v4.35.0)
• Selenium.WebDriver.ChromeDriver (v140.0.7339.18500)
• System.IdentityModel.Tokens.Jwt (v8.14.0)

Configuration

Add your Google API credentials to your configuration:

{
  "Google": {
    "ClientId": "your-google-client-id",
    "ClientSecret": "your-google-client-secret",
    "ApiKey": "your-google-api-key",
    "AnalyticsPropertyId": "your-analytics-property-id",
    "SearchConsoleSiteUrl": "your-site-url"
  }
}

Usage

Basic Setup

using net3000.google;

// Initialize Google Analytics service
var analyticsService = new Analytics(configuration);

// Initialize Search Console service
var searchConsoleService = new SearchConsole(configuration);

// Initialize YouTube service
var youtubeService = new YouTube(configuration);

// Initialize Places service
var placesService = new Places(configuration);

Google Analytics

// Get analytics data
var analyticsData = await analyticsService.GetAnalyticsData(
    propertyId: "your-property-id",
    startDate: "2024-01-01",
    endDate: "2024-01-31"
);

Search Console

// Get search performance data
var searchData = await searchConsoleService.GetSearchPerformance(
    siteUrl: "https://example.com",
    startDate: "2024-01-01",
    endDate: "2024-01-31"
);

YouTube Integration

// Get YouTube channel data
var channelData = await youtubeService.GetChannelData("channel-id");

// Get video analytics
var videoAnalytics = await youtubeService.GetVideoAnalytics("video-id");

Google Maps Places

// Search for places
var places = await placesService.SearchPlaces(
    query: "restaurants near me",
    location: "lat,lng"
);

// Get place details
var placeDetails = await placesService.GetPlaceDetails("place-id");

API Reference

Analytics Class

Google Analytics data retrieval and processing.

Methods

• GetAnalyticsData() - Retrieve analytics data
• GetRealTimeData() - Get real-time analytics
• GetAudienceData() - Retrieve audience information

SearchConsole Class

Google Search Console integration for search performance data.

Methods

• GetSearchPerformance() - Get search performance metrics
• GetSiteMaps() - Retrieve sitemap information
• GetUrlInspection() - Inspect URL indexing status

YouTube Class

YouTube API integration for video and channel management.

Methods

• GetChannelData() - Retrieve channel information
• GetVideoAnalytics() - Get video performance data
• GetPlaylistData() - Retrieve playlist information

Places Class

Google Maps Places API integration for location services.

Methods

• SearchPlaces() - Search for places
• GetPlaceDetails() - Get detailed place information
• GetPlacePhotos() - Retrieve place photos

Models

• AnalyticsStats - Analytics data structure
• SearchConsoleStats - Search Console data structure
• AddressComponent - Address component model
• LatLng - Latitude/longitude coordinates
• PlacesResult - Places search result
• PlaceReview - Place review data
• UserInfo - User information model

Authentication

The library supports multiple authentication methods:

• OAuth2: For user-specific data access
• Service Account: For server-to-server authentication
• API Key: For public data access (Places API, etc.)

Error Handling

Comprehensive error handling with detailed error messages from Google APIs. All methods include proper exception handling and return standardized response objects.

Rate Limiting

The library respects Google API rate limits and includes built-in retry logic and quota management.

Testing

Use Google's test environment for development:

• Create test projects in Google Cloud Console
• Use test API keys and credentials
• Test with limited data sets

Security Considerations

• Store Google credentials securely in configuration
• Use environment variables for production deployments
• Implement proper OAuth2 flow for user authentication
• Monitor API usage and quotas

License

This library is proprietary to Net3000. Usage is restricted to Net3000.ca solutions and authorized affiliates. Redistribution, sublicensing, or integration with third-party products outside the Net3000 ecosystem is prohibited without written consent from Net3000.

Support

For support and questions, contact the Net3000 development team or visit net3000.ca.

Changelog

v1.0.0

• Initial release with comprehensive Google APIs integration
• Analytics, Search Console, YouTube, and Maps functionality
• OAuth2 and service account authentication support
• Comprehensive data models and error handling