trypost/app/Services/Social/YouTubeAnalytics.php

<?php

declare(strict_types=1);

namespace App\Services\Social;

use App\Models\PostPlatform;
use App\Models\SocialAccount;
use App\Services\Social\Concerns\HasSocialHttpClient;
use Carbon\CarbonInterface;
use Illuminate\Http\Client\PendingRequest;
use Illuminate\Support\Facades\Cache;
use Illuminate\Support\Facades\Log;

class YouTubeAnalytics
{
    use HasSocialHttpClient;

    private string $baseUrl;

    private string $accessToken;

    public function __construct()
    {
        $this->baseUrl = config('trypost.platforms.youtube.analytics_api');
    }

    public function getMetrics(SocialAccount $account, ?CarbonInterface $since = null, ?CarbonInterface $until = null): array
    {
        $since ??= now()->subDays(7);
        $until ??= now();

        $cacheKey = "analytics:youtube:{$account->id}:{$since->format('Y-m-d')}:{$until->format('Y-m-d')}";
        $cacheTtl = app()->isProduction() ? 3600 : 1;

        return Cache::remember($cacheKey, $cacheTtl, function () use ($account, $since, $until) {
            return $this->fetchMetricsFromApi($account, $since, $until);
        });
    }

    public function fetchPostMetrics(PostPlatform $postPlatform): array
    {
        $account = $postPlatform->socialAccount;

        if (! $account || ! $postPlatform->platform_post_id) {
            return ['unsupported' => true, 'reason' => 'missing_post_id'];
        }

        if ($account->needsProactiveTokenRefresh()) {
            app(ConnectionVerifier::class)->refreshToken($account);
        }

        $this->accessToken = $account->access_token;

        $publishedAt = $postPlatform->published_at ?? $postPlatform->created_at;
        $startDate = $publishedAt->format('Y-m-d');
        $endDate = now()->format('Y-m-d');

        $response = $this->getHttpClient()
            ->get("{$this->baseUrl}/reports", [
                'ids' => 'channel==MINE',
                'startDate' => $startDate,
                'endDate' => $endDate,
                'metrics' => 'views,estimatedMinutesWatched,averageViewDuration,likes,comments,shares',
                'filters' => "video=={$postPlatform->platform_post_id}",
            ]);

        if ($response->failed()) {
            Log::warning('YouTube post metrics fetch failed', [
                'body' => $this->redactResponseBody($response->body()),
            ]);

            return ['unsupported' => true, 'reason' => 'api_error'];
        }

        $data = $response->json();
        $columns = collect(data_get($data, 'columnHeaders', []))->pluck('name')->all();
        $row = data_get($data, 'rows.0', []);

        $labels = [
            'views' => __('analytics.metrics.views'),
            'estimatedMinutesWatched' => __('analytics.metrics.minutes_watched'),
            'averageViewDuration' => __('analytics.metrics.avg_view_duration'),
            'likes' => __('analytics.metrics.likes'),
            'comments' => __('analytics.metrics.comments'),
            'shares' => __('analytics.metrics.shares'),
        ];

        return collect($columns)
            ->map(fn (string $name, int $i) => [
                'label' => $labels[$name] ?? ucfirst($name),
                'value' => (int) ($row[$i] ?? 0),
            ])
            ->values()
            ->all();
    }

    private function fetchMetricsFromApi(SocialAccount $account, CarbonInterface $since, CarbonInterface $until): array
    {
        if ($account->needsProactiveTokenRefresh()) {
            app(ConnectionVerifier::class)->refreshToken($account);
        }

        $this->accessToken = $account->access_token;

        $response = $this->getHttpClient()
            ->get("{$this->baseUrl}/reports", [
                'ids' => 'channel==MINE',
                'startDate' => $since->format('Y-m-d'),
                'endDate' => $until->format('Y-m-d'),
                'metrics' => 'views,estimatedMinutesWatched,averageViewDuration,averageViewPercentage,subscribersGained,subscribersLost,likes',
            ]);

        if ($response->failed()) {
            Log::warning('YouTube Analytics fetch failed', [
                'status' => $response->status(),
                'body' => $this->redactResponseBody($response->body()),
            ]);

            return [];
        }

        $json = $response->json();
        $rows = data_get($json, 'rows', []);

        if (empty($rows)) {
            return [];
        }

        $columnHeaders = data_get($json, 'columnHeaders', []);
        $metricNames = collect($columnHeaders)->pluck('name')->toArray();
        $values = data_get($rows, '0', []);

        $metrics = [];

        foreach ($metricNames as $index => $name) {
            $value = data_get($values, $index, 0);

            $label = match ($name) {
                'views' => __('analytics.metrics.views'),
                'estimatedMinutesWatched' => __('analytics.metrics.minutes_watched'),
                'averageViewDuration' => __('analytics.metrics.avg_view_duration'),
                'averageViewPercentage' => __('analytics.metrics.avg_view_percentage'),
                'subscribersGained' => __('analytics.metrics.subscribers_gained'),
                'subscribersLost' => __('analytics.metrics.subscribers_lost'),
                'likes' => __('analytics.metrics.likes'),
                default => ucfirst(str_replace('_', ' ', $name)),
            };

            $metrics[] = ['label' => $label, 'value' => round((float) $value, 1)];
        }

        return $metrics;
    }

    private function getHttpClient(): PendingRequest
    {
        return $this->socialHttp()->withToken($this->accessToken);
    }
}