From fa9de5a3770d55564c0d9e46176bb065f5870ebd Mon Sep 17 00:00:00 2001
From: Paulo Castellano <paulo@castellanos.llc>
Date: Mon, 10 Aug 2026 22:47:03 -0300
Subject: [PATCH 01/47] feat: add Google Business Profile platform enum and
 config

---
 .env.example                         |  7 +++++
 app/Enums/SocialAccount/Platform.php | 18 ++++++++++--
 config/services.php                  |  9 ++++++
 config/trypost.php                   | 13 +++++++++
 tests/Unit/Enums/PlatformTest.php    | 43 ++++++++++++++++++++++++++++
 5 files changed, 88 insertions(+), 2 deletions(-)

diff --git a/.env.example b/.env.example
index 2ca8be9ce..3787dac7d 100644
--- a/.env.example
+++ b/.env.example
@@ -149,6 +149,12 @@ GOOGLE_CLIENT_SECRET=
 GOOGLE_CLIENT_REDIRECT="${APP_URL}/accounts/youtube/callback"
 GOOGLE_AUTH_CALLBACK="${APP_URL}/auth/google/callback"
 
+# Google Business Profile (https://console.cloud.google.com)
+# Dedicated OAuth app, isolated from YouTube
+GOOGLE_BUSINESS_CLIENT_ID=
+GOOGLE_BUSINESS_CLIENT_SECRET=
+GOOGLE_BUSINESS_CLIENT_REDIRECT="${APP_URL}/accounts/google-business/callback"
+
 # GitHub (https://github.com/settings/developers)
 # Used for GitHub login/signup
 GITHUB_AUTH_ENABLED=false
@@ -228,6 +234,7 @@ NIGHTWATCH_TOKEN=
 # MASTODON_ENABLED=true
 # BLUESKY_ENABLED=true
 # TELEGRAM_ENABLED=true
+# GOOGLE_BUSINESS_ENABLED=true
 
 # Media Services
 UNSPLASH_ACCESS_KEY=
diff --git a/app/Enums/SocialAccount/Platform.php b/app/Enums/SocialAccount/Platform.php
index e665ed453..12fdc04e2 100644
--- a/app/Enums/SocialAccount/Platform.php
+++ b/app/Enums/SocialAccount/Platform.php
@@ -22,6 +22,7 @@ enum Platform: string
     case Mastodon = 'mastodon';
     case Telegram = 'telegram';
     case Discord = 'discord';
+    case GoogleBusiness = 'google_business';
 
     /**
      * The social network this platform belongs to. Variants that represent the
@@ -69,6 +70,7 @@ public function label(): string
             self::Mastodon => 'Mastodon',
             self::Telegram => 'Telegram',
             self::Discord => 'Discord',
+            self::GoogleBusiness => 'Google Business Profile',
         };
     }
 
@@ -88,6 +90,7 @@ public function color(): string
             self::Mastodon => '#6364FF',
             self::Telegram => '#26A5E4',
             self::Discord => '#5865F2',
+            self::GoogleBusiness => '#4285F4',
         };
     }
 
@@ -106,6 +109,7 @@ public function allowedMediaTypes(): array
             self::Mastodon => [MediaType::Image, MediaType::Video],
             self::Telegram => [MediaType::Image, MediaType::Video],
             self::Discord => [MediaType::Image, MediaType::Video],
+            self::GoogleBusiness => [MediaType::Image],
         };
     }
 
@@ -124,6 +128,7 @@ public function maxImages(): int
             self::Mastodon => 4,
             self::Telegram => 10,
             self::Discord => 10,
+            self::GoogleBusiness => 1,
         };
     }
 
@@ -147,7 +152,7 @@ public function altTextMaxLength(): ?int
             self::Threads => 1000,
             self::Pinterest => 500,
             self::Discord => 1024,
-            self::TikTok, self::YouTube, self::Telegram => null,
+            self::TikTok, self::YouTube, self::Telegram, self::GoogleBusiness => null,
         };
     }
 
@@ -181,6 +186,7 @@ public function supportsAltText(): bool
      *  - Mastodon: 500 default; instances may be higher (we stay conservative)
      *  - Telegram: 4096 for a text message (media captions are capped at 1024,
      *    handled in the publisher by sending long text as its own message)
+     *  - Google Business Profile Local Post `summary`: 1500
      */
     public function maxContentLength(): int
     {
@@ -197,6 +203,7 @@ public function maxContentLength(): int
             self::Mastodon => 500,
             self::Telegram => 4096,
             self::Discord => 2000,
+            self::GoogleBusiness => 1500,
         };
     }
 
@@ -242,6 +249,9 @@ public function recommendedAiContentLength(): int
             self::Telegram => 400,
             // Discord — conversational community posts read best when concise
             self::Discord => 280,
+            // Google Business Profile — image does most of the work, keep the
+            // summary tight and scannable
+            self::GoogleBusiness => 300,
         };
     }
 
@@ -265,6 +275,7 @@ public function requiredPublishScopes(): array
             self::Mastodon => ['write:statuses'],
             self::Telegram => [],
             self::Discord => [],
+            self::GoogleBusiness => ['https://www.googleapis.com/auth/business.manage'],
         };
     }
 
@@ -283,6 +294,7 @@ public function supportsTextOnly(): bool
             self::Mastodon => true,
             self::Telegram => true,
             self::Discord => true,
+            self::GoogleBusiness => true,
         };
     }
 
@@ -324,7 +336,7 @@ public function hasTokenRefreshFlow(): bool
         return match ($this) {
             self::LinkedIn, self::LinkedInPage, self::X, self::Bluesky,
             self::YouTube, self::TikTok, self::Pinterest,
-            self::Threads, self::Instagram => true,
+            self::Threads, self::Instagram, self::GoogleBusiness => true,
             default => false,
         };
     }
@@ -352,6 +364,7 @@ public static function accessTokenExtendingPlatformValues(): array
      *
      *  - X: a 2-hour access token.
      *  - Instagram / Threads: Meta's 60-day long-lived token.
+     *  - Google Business Profile: standard Google OAuth2 1-hour access token.
      *
      * Networks that always return expires_in (LinkedIn, TikTok, YouTube,
      * Pinterest), whose refresh sets a fixed lifetime directly (Bluesky), or
@@ -362,6 +375,7 @@ public function defaultTokenTtlSeconds(): ?int
     {
         return match ($this) {
             self::X => 7200,
+            self::GoogleBusiness => 3600,
             self::Instagram, self::Threads => 5184000,
             default => null,
         };
diff --git a/config/services.php b/config/services.php
index 4b5d5690f..94f3e58b0 100644
--- a/config/services.php
+++ b/config/services.php
@@ -117,6 +117,15 @@
         'redirect' => env('DISCORD_CLIENT_REDIRECT'),
     ],
 
+    // Google Business Profile — dedicated OAuth app, isolated from 'google'
+    // (YouTube) so adding the sensitive business.manage scope never triggers
+    // Google to re-review the YouTube app's already-verified scope set.
+    'google-business' => [
+        'client_id' => env('GOOGLE_BUSINESS_CLIENT_ID'),
+        'client_secret' => env('GOOGLE_BUSINESS_CLIENT_SECRET'),
+        'redirect' => env('GOOGLE_BUSINESS_CLIENT_REDIRECT'),
+    ],
+
     'gtm' => [
         'id' => env('GTM_ID'),
     ],
diff --git a/config/trypost.php b/config/trypost.php
index acb68a9a6..9127d8cea 100644
--- a/config/trypost.php
+++ b/config/trypost.php
@@ -218,6 +218,19 @@
             'permissions' => env('DISCORD_PERMISSIONS', '248832'),
             'scopes' => array_values(array_filter(array_map('trim', explode(',', (string) env('DISCORD_SCOPES', 'bot,identify,guilds'))))),
         ],
+        'google_business' => [
+            'enabled' => env('GOOGLE_BUSINESS_ENABLED', true),
+            // Account Management API — lists the Business accounts a user administers.
+            'account_management_api' => env('GOOGLE_BUSINESS_ACCOUNT_MANAGEMENT_API', 'https://mybusinessaccountmanagement.googleapis.com/v1'),
+            // Business Information API — lists locations under an account.
+            'business_information_api' => env('GOOGLE_BUSINESS_BUSINESS_INFORMATION_API', 'https://mybusinessbusinessinformation.googleapis.com/v1'),
+            // Legacy but still-active v4 API — the only home for Local Post create/update/delete.
+            'local_posts_api' => env('GOOGLE_BUSINESS_LOCAL_POSTS_API', 'https://mybusiness.googleapis.com/v4'),
+            // Business Profile Performance API — location-level analytics.
+            'performance_api' => env('GOOGLE_BUSINESS_PERFORMANCE_API', 'https://businessprofileperformance.googleapis.com/v1'),
+            // OAuth token endpoint, same host Google uses for every OAuth2 client.
+            'oauth_api' => env('GOOGLE_BUSINESS_OAUTH_API', 'https://oauth2.googleapis.com'),
+        ],
     ],
 
 ];
diff --git a/tests/Unit/Enums/PlatformTest.php b/tests/Unit/Enums/PlatformTest.php
index 803756c5c..961e3f46f 100644
--- a/tests/Unit/Enums/PlatformTest.php
+++ b/tests/Unit/Enums/PlatformTest.php
@@ -187,3 +187,46 @@
         Platform::InstagramFacebook->value,
     ]);
 });
+
+test('google business has correct label and color', function () {
+    expect(Platform::GoogleBusiness->label())->toBe('Google Business Profile');
+    expect(Platform::GoogleBusiness->color())->toBe('#4285F4');
+});
+
+test('google business has correct media rules', function () {
+    expect(Platform::GoogleBusiness->allowedMediaTypes())->toBe([MediaType::Image]);
+    expect(Platform::GoogleBusiness->maxImages())->toBe(1);
+    expect(Platform::GoogleBusiness->supportsAltText())->toBeFalse();
+    expect(Platform::GoogleBusiness->maxContentLength())->toBe(1500);
+});
+
+test('google business supports text-only posts and requires no content by default', function () {
+    expect(Platform::GoogleBusiness->supportsTextOnly())->toBeTrue();
+    expect(Platform::GoogleBusiness->requiresContent())->toBeFalse();
+});
+
+test('google business has a real token refresh flow with a 1 hour default ttl', function () {
+    expect(Platform::GoogleBusiness->hasTokenRefreshFlow())->toBeTrue();
+    expect(Platform::GoogleBusiness->defaultTokenTtlSeconds())->toBe(3600);
+});
+
+test('google business requires the business.manage scope to publish', function () {
+    expect(Platform::GoogleBusiness->requiredPublishScopes())->toBe([
+        'https://www.googleapis.com/auth/business.manage',
+    ]);
+});
+
+test('google business queue name is scoped to the platform', function () {
+    expect(Platform::GoogleBusiness->queue())->toBe('social-google_business');
+});
+
+test('google business is enabled by default and connectable', function () {
+    expect(Platform::GoogleBusiness->isEnabled())->toBeTrue();
+    expect(Platform::GoogleBusiness->isConnectable())->toBeTrue();
+});
+
+test('google business can be disabled via config', function () {
+    config(['trypost.platforms.google_business.enabled' => false]);
+
+    expect(Platform::GoogleBusiness->isEnabled())->toBeFalse();
+});

From 0f5cdbf7cfe6153b9b25e1806d9fde19c412054c Mon Sep 17 00:00:00 2001
From: Paulo Castellano <paulo@castellanos.llc>
Date: Mon, 10 Aug 2026 22:55:28 -0300
Subject: [PATCH 02/47] feat: add GoogleBusinessPost content type

---
 app/Enums/PostPlatform/ContentType.php |  9 +++++++++
 lang/ar/posts.php                      |  4 ++++
 lang/de/posts.php                      |  4 ++++
 lang/el/posts.php                      |  4 ++++
 lang/en/posts.php                      |  4 ++++
 lang/es/posts.php                      |  4 ++++
 lang/fr/posts.php                      |  4 ++++
 lang/it/posts.php                      |  4 ++++
 lang/ja/posts.php                      |  4 ++++
 lang/ko/posts.php                      |  4 ++++
 lang/nl/posts.php                      |  4 ++++
 lang/pl/posts.php                      |  4 ++++
 lang/pt-BR/posts.php                   |  4 ++++
 lang/ru/posts.php                      |  4 ++++
 lang/tr/posts.php                      |  4 ++++
 lang/uk/posts.php                      |  4 ++++
 lang/zh/posts.php                      |  4 ++++
 tests/Unit/Enums/ContentTypeTest.php   | 15 +++++++++++++++
 18 files changed, 88 insertions(+)

diff --git a/app/Enums/PostPlatform/ContentType.php b/app/Enums/PostPlatform/ContentType.php
index 0d56e74cd..c6ea21c5d 100644
--- a/app/Enums/PostPlatform/ContentType.php
+++ b/app/Enums/PostPlatform/ContentType.php
@@ -56,6 +56,9 @@ enum ContentType: string
     // Discord
     case DiscordMessage = 'discord_message';
 
+    // Google Business Profile
+    case GoogleBusinessPost = 'google_business_post';
+
     /**
      * AI generation format for an Instagram carousel. Not a content type —
      * carousel posts are persisted as InstagramFeed.
@@ -84,6 +87,7 @@ public function label(): string
             self::MastodonPost => 'Post',
             self::TelegramPost => 'Post',
             self::DiscordMessage => 'Message',
+            self::GoogleBusinessPost => 'Post',
         };
     }
 
@@ -108,6 +112,7 @@ public function platform(): SocialPlatform
             self::MastodonPost => SocialPlatform::Mastodon,
             self::TelegramPost => SocialPlatform::Telegram,
             self::DiscordMessage => SocialPlatform::Discord,
+            self::GoogleBusinessPost => SocialPlatform::GoogleBusiness,
         };
     }
 
@@ -177,6 +182,7 @@ public function maxMediaCount(): int
             self::MastodonPost => 4,
             self::TelegramPost => 10,
             self::DiscordMessage => 10,
+            self::GoogleBusinessPost => 1,
         };
     }
 
@@ -458,6 +464,7 @@ public function supportsVideo(): bool
             self::MastodonPost => true,
             self::TelegramPost => true,
             self::DiscordMessage => true,
+            self::GoogleBusinessPost => false,
         };
     }
 
@@ -526,6 +533,7 @@ public function requiresMedia(): bool
             self::TelegramPost => false,
             self::FacebookPost => false,
             self::DiscordMessage => false,
+            self::GoogleBusinessPost => false,
             default => true,
         };
     }
@@ -609,6 +617,7 @@ public static function defaultFor(SocialPlatform $platform): self
             SocialPlatform::Mastodon => self::MastodonPost,
             SocialPlatform::Telegram => self::TelegramPost,
             SocialPlatform::Discord => self::DiscordMessage,
+            SocialPlatform::GoogleBusiness => self::GoogleBusinessPost,
         };
     }
 }
diff --git a/lang/ar/posts.php b/lang/ar/posts.php
index c61611e59..3b507f9da 100644
--- a/lang/ar/posts.php
+++ b/lang/ar/posts.php
@@ -550,6 +550,10 @@
             'label' => 'رسالة',
             'description' => 'رسالة إلى قناة Discord مع وسائط وتضمينات اختيارية',
         ],
+        'google_business_post' => [
+            'label' => 'منشور',
+            'description' => 'يظهر على ملفك التجاري في البحث والخرائط',
+        ],
     ],
 
     'platforms' => [
diff --git a/lang/de/posts.php b/lang/de/posts.php
index bd79bfa3e..52b722d7b 100644
--- a/lang/de/posts.php
+++ b/lang/de/posts.php
@@ -552,6 +552,10 @@
             'label' => 'Nachricht',
             'description' => 'Nachricht an einen Discord-Kanal mit optionalen Medien & Embeds',
         ],
+        'google_business_post' => [
+            'label' => 'Beitrag',
+            'description' => 'Wird in deinem Geschäftsprofil in Suche und Karten angezeigt',
+        ],
     ],
 
     'platforms' => [
diff --git a/lang/el/posts.php b/lang/el/posts.php
index 04d8992e1..d8dda04b4 100644
--- a/lang/el/posts.php
+++ b/lang/el/posts.php
@@ -550,6 +550,10 @@
             'label' => 'Μήνυμα',
             'description' => 'Μήνυμα σε κανάλι Discord με προαιρετικά πολυμέσα και embeds',
         ],
+        'google_business_post' => [
+            'label' => 'Δημοσίευση',
+            'description' => 'Εμφανίζεται στο Επιχειρηματικό σας Προφίλ στην Αναζήτηση και τους Χάρτες',
+        ],
     ],
 
     'platforms' => [
diff --git a/lang/en/posts.php b/lang/en/posts.php
index 4ce09e420..671a3f219 100644
--- a/lang/en/posts.php
+++ b/lang/en/posts.php
@@ -550,6 +550,10 @@
             'label' => 'Message',
             'description' => 'Message to a Discord channel with optional media & embeds',
         ],
+        'google_business_post' => [
+            'label' => 'Post',
+            'description' => 'Appears on your Business Profile in Search and Maps',
+        ],
     ],
 
     'platforms' => [
diff --git a/lang/es/posts.php b/lang/es/posts.php
index 957d4d1a3..92e4e1093 100644
--- a/lang/es/posts.php
+++ b/lang/es/posts.php
@@ -550,6 +550,10 @@
             'label' => 'Mensaje',
             'description' => 'Mensaje a un canal de Discord con multimedia y embeds opcionales',
         ],
+        'google_business_post' => [
+            'label' => 'Publicación',
+            'description' => 'Aparece en tu Perfil Empresarial en Búsqueda y Mapas',
+        ],
     ],
 
     'platforms' => [
diff --git a/lang/fr/posts.php b/lang/fr/posts.php
index 1983643a7..69c09ab55 100644
--- a/lang/fr/posts.php
+++ b/lang/fr/posts.php
@@ -550,6 +550,10 @@
             'label' => 'Message',
             'description' => 'Message vers un salon Discord avec médias et embeds facultatifs',
         ],
+        'google_business_post' => [
+            'label' => 'Publication',
+            'description' => 'Apparaît dans votre Profil Entreprise dans la Recherche et Cartes',
+        ],
     ],
 
     'platforms' => [
diff --git a/lang/it/posts.php b/lang/it/posts.php
index 6460e6cb2..60eb1cd2d 100644
--- a/lang/it/posts.php
+++ b/lang/it/posts.php
@@ -550,6 +550,10 @@
             'label' => 'Messaggio',
             'description' => 'Messaggio a un canale Discord con media ed embed facoltativi',
         ],
+        'google_business_post' => [
+            'label' => 'Pubblicazione',
+            'description' => 'Appare nel tuo Profilo Aziendale in Ricerca e Mappe',
+        ],
     ],
 
     'platforms' => [
diff --git a/lang/ja/posts.php b/lang/ja/posts.php
index cdae132c2..0d42cef6b 100644
--- a/lang/ja/posts.php
+++ b/lang/ja/posts.php
@@ -550,6 +550,10 @@
             'label' => 'メッセージ',
             'description' => 'メディアと埋め込み（任意）付きの Discord チャンネルへのメッセージ',
         ],
+        'google_business_post' => [
+            'label' => '投稿',
+            'description' => 'ビジネス プロフィールに検索とマップで表示されます',
+        ],
     ],
 
     'platforms' => [
diff --git a/lang/ko/posts.php b/lang/ko/posts.php
index ee4a20fa7..65670101d 100644
--- a/lang/ko/posts.php
+++ b/lang/ko/posts.php
@@ -550,6 +550,10 @@
             'label' => '메시지',
             'description' => '선택적 미디어 및 임베드가 있는 Discord 채널 메시지',
         ],
+        'google_business_post' => [
+            'label' => '게시물',
+            'description' => '비즈니스 프로필에 검색 및 지도에 표시됩니다',
+        ],
     ],
 
     'platforms' => [
diff --git a/lang/nl/posts.php b/lang/nl/posts.php
index d9ef79626..1c70e3972 100644
--- a/lang/nl/posts.php
+++ b/lang/nl/posts.php
@@ -550,6 +550,10 @@
             'label' => 'Bericht',
             'description' => 'Bericht naar een Discord-kanaal met optionele media en embeds',
         ],
+        'google_business_post' => [
+            'label' => 'Bericht',
+            'description' => 'Wordt weergegeven in je Bedrijfsprofiel in Zoeken en Kaarten',
+        ],
     ],
 
     'platforms' => [
diff --git a/lang/pl/posts.php b/lang/pl/posts.php
index 3f9732a8e..79779b76b 100644
--- a/lang/pl/posts.php
+++ b/lang/pl/posts.php
@@ -550,6 +550,10 @@
             'label' => 'Wiadomość',
             'description' => 'Wiadomość na kanale Discord z opcjonalnymi multimediami i osadzeniami',
         ],
+        'google_business_post' => [
+            'label' => 'Post',
+            'description' => 'Pojawia się w twoim Profilu Biznesowym w Wyszukiwaniu i Mapach',
+        ],
     ],
 
     'platforms' => [
diff --git a/lang/pt-BR/posts.php b/lang/pt-BR/posts.php
index a13828d37..34a7029d1 100644
--- a/lang/pt-BR/posts.php
+++ b/lang/pt-BR/posts.php
@@ -550,6 +550,10 @@
             'label' => 'Mensagem',
             'description' => 'Mensagem para um canal do Discord com mídia e embeds opcionais',
         ],
+        'google_business_post' => [
+            'label' => 'Publicação',
+            'description' => 'Aparece no seu Perfil Empresarial em Pesquisa e Mapas',
+        ],
     ],
 
     'platforms' => [
diff --git a/lang/ru/posts.php b/lang/ru/posts.php
index 9787313b2..d826a3ded 100644
--- a/lang/ru/posts.php
+++ b/lang/ru/posts.php
@@ -550,6 +550,10 @@
             'label' => 'Сообщение',
             'description' => 'Сообщение в канал Discord с опциональным медиа и встраиваниями',
         ],
+        'google_business_post' => [
+            'label' => 'Пост',
+            'description' => 'Отображается в вашем Профиле компании в Поиске и Картах',
+        ],
     ],
 
     'platforms' => [
diff --git a/lang/tr/posts.php b/lang/tr/posts.php
index 5cb220c56..0a39c1774 100644
--- a/lang/tr/posts.php
+++ b/lang/tr/posts.php
@@ -552,6 +552,10 @@
             'label' => 'Mesaj',
             'description' => 'İsteğe bağlı medya ve yerleştirmeler içeren Discord kanalına mesaj',
         ],
+        'google_business_post' => [
+            'label' => 'Gönderi',
+            'description' => 'İşletme Profilinde Arama ve Haritalar\'da görünür',
+        ],
     ],
 
     'platforms' => [
diff --git a/lang/uk/posts.php b/lang/uk/posts.php
index 8dc88b8c1..7ff1b27bf 100644
--- a/lang/uk/posts.php
+++ b/lang/uk/posts.php
@@ -550,6 +550,10 @@
             'label' => 'Повідомлення',
             'description' => 'Повідомлення в канал Discord із необов’язковим медіа та вбудовуваннями',
         ],
+        'google_business_post' => [
+            'label' => 'Публікація',
+            'description' => 'Відображається у вашому Профілі компанії в Пошуку та Картах',
+        ],
     ],
 
     'platforms' => [
diff --git a/lang/zh/posts.php b/lang/zh/posts.php
index 449ed49e7..39482adbd 100644
--- a/lang/zh/posts.php
+++ b/lang/zh/posts.php
@@ -550,6 +550,10 @@
             'label' => '消息',
             'description' => '发送到 Discord 频道的消息，可附带媒体和嵌入内容',
         ],
+        'google_business_post' => [
+            'label' => '帖子',
+            'description' => '在搜索和地图中显示在您的商业资料中',
+        ],
     ],
 
     'platforms' => [
diff --git a/tests/Unit/Enums/ContentTypeTest.php b/tests/Unit/Enums/ContentTypeTest.php
index aa87067af..af04169a1 100644
--- a/tests/Unit/Enums/ContentTypeTest.php
+++ b/tests/Unit/Enums/ContentTypeTest.php
@@ -351,3 +351,18 @@
     expect(ContentType::forPlatform(Platform::LinkedIn))->toHaveCount(1)->toContain(ContentType::LinkedInPost);
     expect(ContentType::forPlatform(Platform::LinkedInPage))->toHaveCount(1)->toContain(ContentType::LinkedInPagePost);
 });
+
+test('google business post maps to the google business platform', function () {
+    expect(ContentType::GoogleBusinessPost->platform())->toBe(Platform::GoogleBusiness);
+});
+
+test('google business post media rules allow at most one image, no video', function () {
+    expect(ContentType::GoogleBusinessPost->maxMediaCount())->toBe(1);
+    expect(ContentType::GoogleBusinessPost->supportsVideo())->toBeFalse();
+    expect(ContentType::GoogleBusinessPost->supportsImage())->toBeTrue();
+    expect(ContentType::GoogleBusinessPost->requiresMedia())->toBeFalse();
+});
+
+test('google business post is the default content type for the platform', function () {
+    expect(ContentType::defaultFor(Platform::GoogleBusiness))->toBe(ContentType::GoogleBusinessPost);
+});

From ddba0b1a2ebd38bce429b9887b2e0026785b8842 Mon Sep 17 00:00:00 2001
From: Paulo Castellano <paulo@castellanos.llc>
Date: Mon, 10 Aug 2026 23:03:37 -0300
Subject: [PATCH 03/47] feat: add Google Business Profile post meta validation
 rules

---
 app/Support/PostPlatformMetaRules.php       | 27 ++++++++++++++
 database/factories/PostPlatformFactory.php  |  8 +++++
 database/factories/SocialAccountFactory.php | 14 ++++++++
 lang/ar/posts.php                           | 35 ++++++++++++++++++
 lang/de/posts.php                           | 35 ++++++++++++++++++
 lang/el/posts.php                           | 35 ++++++++++++++++++
 lang/en/posts.php                           | 35 ++++++++++++++++++
 lang/es/posts.php                           | 35 ++++++++++++++++++
 lang/fr/posts.php                           | 35 ++++++++++++++++++
 lang/it/posts.php                           | 35 ++++++++++++++++++
 lang/ja/posts.php                           | 35 ++++++++++++++++++
 lang/ko/posts.php                           | 35 ++++++++++++++++++
 lang/nl/posts.php                           | 35 ++++++++++++++++++
 lang/pl/posts.php                           | 35 ++++++++++++++++++
 lang/pt-BR/posts.php                        | 35 ++++++++++++++++++
 lang/ru/posts.php                           | 35 ++++++++++++++++++
 lang/tr/posts.php                           | 35 ++++++++++++++++++
 lang/uk/posts.php                           | 35 ++++++++++++++++++
 lang/zh/posts.php                           | 35 ++++++++++++++++++
 tests/Unit/PostPlatformMetaRulesTest.php    | 39 +++++++++++++++++++++
 20 files changed, 648 insertions(+)

diff --git a/app/Support/PostPlatformMetaRules.php b/app/Support/PostPlatformMetaRules.php
index 15cc71046..e43be4f23 100644
--- a/app/Support/PostPlatformMetaRules.php
+++ b/app/Support/PostPlatformMetaRules.php
@@ -76,6 +76,22 @@ public static function rules(): array
             'platforms.*.meta.embeds.*.url' => ['sometimes', 'nullable', 'url'],
             'platforms.*.meta.embeds.*.image' => ['sometimes', 'nullable', 'url'],
             'platforms.*.meta.embeds.*.color' => ['sometimes', 'nullable', 'string', 'regex:/^#?[0-9A-Fa-f]{6}$/'],
+
+            // Google Business Profile
+            'platforms.*.meta.topic_type' => ['sometimes', 'nullable', 'string', Rule::in(['STANDARD', 'EVENT', 'OFFER'])],
+            'platforms.*.meta.call_to_action' => ['sometimes', 'nullable', 'array'],
+            'platforms.*.meta.call_to_action.action_type' => ['sometimes', 'nullable', 'string', Rule::in(['NONE', 'BOOK', 'ORDER', 'SHOP', 'LEARN_MORE', 'SIGN_UP', 'GET_OFFER', 'CALL'])],
+            'platforms.*.meta.call_to_action.url' => ['required_unless:platforms.*.meta.call_to_action.action_type,NONE,CALL', 'nullable', 'url:http,https', 'max:2048'],
+            'platforms.*.meta.event' => ['sometimes', 'nullable', 'array'],
+            'platforms.*.meta.event.title' => ['sometimes', 'nullable', 'string', 'max:100'],
+            'platforms.*.meta.event.start_date' => ['sometimes', 'nullable', 'date'],
+            'platforms.*.meta.event.end_date' => ['sometimes', 'nullable', 'date', 'after_or_equal:platforms.*.meta.event.start_date'],
+            'platforms.*.meta.event.start_time' => ['sometimes', 'nullable', 'date_format:H:i'],
+            'platforms.*.meta.event.end_time' => ['sometimes', 'nullable', 'date_format:H:i'],
+            'platforms.*.meta.offer' => ['sometimes', 'nullable', 'array'],
+            'platforms.*.meta.offer.coupon_code' => ['sometimes', 'nullable', 'string', 'max:58'],
+            'platforms.*.meta.offer.redeem_online_url' => ['sometimes', 'nullable', 'url:http,https', 'max:2048'],
+            'platforms.*.meta.offer.terms_conditions' => ['sometimes', 'nullable', 'string', 'max:5000'],
         ];
     }
 
@@ -103,6 +119,8 @@ public static function attributes(): array
         return [
             'platforms.*.meta.title' => __('posts.form.pinterest.title'),
             'platforms.*.meta.link' => __('posts.form.pinterest.link'),
+            'platforms.*.meta.event.title' => __('posts.form.google_business.event_title'),
+            'platforms.*.meta.call_to_action.url' => __('posts.form.google_business.cta_url'),
         ];
     }
 
@@ -166,6 +184,15 @@ private static function requiredMetaViolation(?Platform $platform, mixed $meta):
             $platform === Platform::TikTok && blank(data_get($meta, 'privacy_level')) => ['privacy_level', trans('posts.form.tiktok.privacy_required')],
             $platform === Platform::Pinterest && blank(data_get($meta, 'board_id')) => ['board_id', trans('posts.form.pinterest.board_required')],
             $platform === Platform::Discord && blank(data_get($meta, 'channel_id')) => ['channel_id', trans('posts.form.discord.channel_required')],
+            $platform === Platform::GoogleBusiness
+                && data_get($meta, 'topic_type', 'STANDARD') === 'EVENT'
+                && blank(data_get($meta, 'event.title')) => ['event.title', trans('posts.form.google_business.event_title_required')],
+            $platform === Platform::GoogleBusiness
+                && data_get($meta, 'topic_type', 'STANDARD') === 'EVENT'
+                && blank(data_get($meta, 'event.start_date')) => ['event.start_date', trans('posts.form.google_business.event_start_date_required')],
+            $platform === Platform::GoogleBusiness
+                && data_get($meta, 'topic_type', 'STANDARD') === 'EVENT'
+                && blank(data_get($meta, 'event.end_date')) => ['event.end_date', trans('posts.form.google_business.event_end_date_required')],
             default => null,
         };
     }
diff --git a/database/factories/PostPlatformFactory.php b/database/factories/PostPlatformFactory.php
index cb39e970f..7312e6ea8 100644
--- a/database/factories/PostPlatformFactory.php
+++ b/database/factories/PostPlatformFactory.php
@@ -131,6 +131,14 @@ public function pinterest(): static
         ]);
     }
 
+    public function googleBusiness(): static
+    {
+        return $this->state(fn (array $attributes) => [
+            'platform' => Platform::GoogleBusiness,
+            'content_type' => ContentType::GoogleBusinessPost,
+        ]);
+    }
+
     public function pinterestVideoPin(): static
     {
         return $this->state(fn (array $attributes) => [
diff --git a/database/factories/SocialAccountFactory.php b/database/factories/SocialAccountFactory.php
index 927aba12a..3087f9fb9 100644
--- a/database/factories/SocialAccountFactory.php
+++ b/database/factories/SocialAccountFactory.php
@@ -109,6 +109,20 @@ public function pinterest(): static
         ]);
     }
 
+    public function googleBusiness(): static
+    {
+        return $this->state(fn (array $attributes) => [
+            'platform' => Platform::GoogleBusiness,
+            'scopes' => Platform::GoogleBusiness->requiredPublishScopes(),
+            'meta' => [
+                'location_id' => 'accounts/123456789/locations/987654321',
+                'account_name' => 'accounts/123456789',
+                'location_name' => 'locations/987654321',
+                'google_user_id' => 'google-user-123',
+            ],
+        ]);
+    }
+
     public function bluesky(): static
     {
         return $this->state(fn (array $attributes) => [
diff --git a/lang/ar/posts.php b/lang/ar/posts.php
index 3b507f9da..10d84dcec 100644
--- a/lang/ar/posts.php
+++ b/lang/ar/posts.php
@@ -186,6 +186,41 @@
             'embed_image' => 'رابط الصورة',
             'embed_color' => 'اللون',
         ],
+        'google_business' => [
+            'settings' => 'إعدادات ملف Google Business Profile',
+            'posting_to' => 'النشر إلى',
+            'topic_type_label' => 'نوع المنشور',
+            'topic_type' => [
+                'standard' => 'تحديث',
+                'event' => 'حدث',
+                'offer' => 'عرض',
+            ],
+            'cta_label' => 'زر',
+            'cta_none' => 'بدون زر',
+            'cta' => [
+                'book' => 'احجز',
+                'order' => 'اطلب عبر الإنترنت',
+                'shop' => 'اشتر',
+                'learn_more' => 'تعرف على المزيد',
+                'sign_up' => 'اشترك',
+                'get_offer' => 'احصل على العرض',
+                'call' => 'اتصل الآن',
+            ],
+            'cta_url' => 'رابط الزر',
+            'cta_url_placeholder' => 'https://example.com',
+            'event_title' => 'عنوان الحدث',
+            'event_title_placeholder' => 'عرض الصيف',
+            'event_title_required' => 'أدخل عنوان الحدث.',
+            'event_start_date' => 'تاريخ البدء',
+            'event_start_date_required' => 'أدخل تاريخ البدء.',
+            'event_end_date' => 'تاريخ الانتهاء',
+            'event_end_date_required' => 'أدخل تاريخ الانتهاء.',
+            'event_start_time' => 'وقت البدء',
+            'event_end_time' => 'وقت الانتهاء',
+            'offer_coupon_code' => 'رمز القسيمة',
+            'offer_redeem_url' => 'رابط الاسترداد عبر الإنترنت',
+            'offer_terms' => 'الشروط والأحكام',
+        ],
         'warnings' => [
             'no_variant' => 'اختر نوع منشور للمتابعة.',
             'requires_media' => 'يتطلب هذا النوع من المنشورات صورة أو فيديو واحدًا على الأقل.',
diff --git a/lang/de/posts.php b/lang/de/posts.php
index 52b722d7b..4b2cd36f0 100644
--- a/lang/de/posts.php
+++ b/lang/de/posts.php
@@ -188,6 +188,41 @@
             'embed_image' => 'Bild-URL',
             'embed_color' => 'Farbe',
         ],
+        'google_business' => [
+            'settings' => 'Google Business Profile-Einstellungen',
+            'posting_to' => 'Veröffentlichen auf',
+            'topic_type_label' => 'Beitragstyp',
+            'topic_type' => [
+                'standard' => 'Aktualisierung',
+                'event' => 'Veranstaltung',
+                'offer' => 'Angebot',
+            ],
+            'cta_label' => 'Schaltfläche',
+            'cta_none' => 'Keine Schaltfläche',
+            'cta' => [
+                'book' => 'Buchen',
+                'order' => 'Online bestellen',
+                'shop' => 'Kaufen',
+                'learn_more' => 'Mehr erfahren',
+                'sign_up' => 'Anmelden',
+                'get_offer' => 'Angebot nutzen',
+                'call' => 'Jetzt anrufen',
+            ],
+            'cta_url' => 'Schaltflächenlink',
+            'cta_url_placeholder' => 'https://example.com',
+            'event_title' => 'Veranstaltungstitel',
+            'event_title_placeholder' => 'Sommerverkauf',
+            'event_title_required' => 'Gib einen Veranstaltungstitel ein.',
+            'event_start_date' => 'Startdatum',
+            'event_start_date_required' => 'Gib ein Startdatum ein.',
+            'event_end_date' => 'Enddatum',
+            'event_end_date_required' => 'Gib ein Enddatum ein.',
+            'event_start_time' => 'Startzeit',
+            'event_end_time' => 'Endzeit',
+            'offer_coupon_code' => 'Gutscheincode',
+            'offer_redeem_url' => 'Online-Einlösungslink',
+            'offer_terms' => 'Geschäftsbedingungen',
+        ],
         'warnings' => [
             'no_variant' => 'Wähle einen Beitragstyp, um fortzufahren.',
             'requires_media' => 'Dieser Beitragstyp erfordert mindestens ein Bild oder Video.',
diff --git a/lang/el/posts.php b/lang/el/posts.php
index d8dda04b4..33de913ab 100644
--- a/lang/el/posts.php
+++ b/lang/el/posts.php
@@ -186,6 +186,41 @@
             'embed_image' => 'URL εικόνας',
             'embed_color' => 'Χρώμα',
         ],
+        'google_business' => [
+            'settings' => 'Ρυθμίσεις Google Business Profile',
+            'posting_to' => 'Δημοσίευση σε',
+            'topic_type_label' => 'Τύπος δημοσίευσης',
+            'topic_type' => [
+                'standard' => 'Ενημέρωση',
+                'event' => 'Εκδήλωση',
+                'offer' => 'Προσφορά',
+            ],
+            'cta_label' => 'Κουμπί',
+            'cta_none' => 'Χωρίς κουμπί',
+            'cta' => [
+                'book' => 'Κράτηση',
+                'order' => 'Παραγγελία online',
+                'shop' => 'Αγορά',
+                'learn_more' => 'Μάθετε περισσότερα',
+                'sign_up' => 'Εγγραφή',
+                'get_offer' => 'Λάβετε προσφορά',
+                'call' => 'Καλέστε τώρα',
+            ],
+            'cta_url' => 'Σύνδεσμος κουμπιού',
+            'cta_url_placeholder' => 'https://example.com',
+            'event_title' => 'Τίτλος εκδήλωσης',
+            'event_title_placeholder' => 'Θερινή έκπτωση',
+            'event_title_required' => 'Εισάγετε τίτλο εκδήλωσης.',
+            'event_start_date' => 'Ημερομηνία έναρξης',
+            'event_start_date_required' => 'Εισάγετε ημερομηνία έναρξης.',
+            'event_end_date' => 'Ημερομηνία λήξης',
+            'event_end_date_required' => 'Εισάγετε ημερομηνία λήξης.',
+            'event_start_time' => 'Ώρα έναρξης',
+            'event_end_time' => 'Ώρα λήξης',
+            'offer_coupon_code' => 'Κωδικός κουπονιού',
+            'offer_redeem_url' => 'Σύνδεσμος εξαργύρωσης online',
+            'offer_terms' => 'Όροι και προϋποθέσεις',
+        ],
         'warnings' => [
             'no_variant' => 'Επιλέξτε έναν τύπο δημοσίευσης για να συνεχίσετε.',
             'requires_media' => 'Αυτός ο τύπος δημοσίευσης απαιτεί τουλάχιστον μία εικόνα ή βίντεο.',
diff --git a/lang/en/posts.php b/lang/en/posts.php
index 671a3f219..a8ca58a7f 100644
--- a/lang/en/posts.php
+++ b/lang/en/posts.php
@@ -186,6 +186,41 @@
             'embed_image' => 'Image URL',
             'embed_color' => 'Color',
         ],
+        'google_business' => [
+            'settings' => 'Google Business Profile Settings',
+            'posting_to' => 'Posting to',
+            'topic_type_label' => 'Post type',
+            'topic_type' => [
+                'standard' => 'Update',
+                'event' => 'Event',
+                'offer' => 'Offer',
+            ],
+            'cta_label' => 'Button',
+            'cta_none' => 'No button',
+            'cta' => [
+                'book' => 'Book',
+                'order' => 'Order online',
+                'shop' => 'Buy',
+                'learn_more' => 'Learn more',
+                'sign_up' => 'Sign up',
+                'get_offer' => 'Redeem offer',
+                'call' => 'Call now',
+            ],
+            'cta_url' => 'Button link',
+            'cta_url_placeholder' => 'https://example.com',
+            'event_title' => 'Event title',
+            'event_title_placeholder' => 'Summer sale',
+            'event_title_required' => 'Enter an event title.',
+            'event_start_date' => 'Start date',
+            'event_start_date_required' => 'Enter an event start date.',
+            'event_end_date' => 'End date',
+            'event_end_date_required' => 'Enter an event end date.',
+            'event_start_time' => 'Start time',
+            'event_end_time' => 'End time',
+            'offer_coupon_code' => 'Coupon code',
+            'offer_redeem_url' => 'Redeem online link',
+            'offer_terms' => 'Terms & conditions',
+        ],
         'warnings' => [
             'no_variant' => 'Pick a post type to continue.',
             'requires_media' => 'This post type requires at least one image or video.',
diff --git a/lang/es/posts.php b/lang/es/posts.php
index 92e4e1093..1eb0e3d05 100644
--- a/lang/es/posts.php
+++ b/lang/es/posts.php
@@ -186,6 +186,41 @@
             'embed_image' => 'URL de la imagen',
             'embed_color' => 'Color',
         ],
+        'google_business' => [
+            'settings' => 'Configuración de Google Business Profile',
+            'posting_to' => 'Publicando en',
+            'topic_type_label' => 'Tipo de publicación',
+            'topic_type' => [
+                'standard' => 'Actualización',
+                'event' => 'Evento',
+                'offer' => 'Oferta',
+            ],
+            'cta_label' => 'Botón',
+            'cta_none' => 'Sin botón',
+            'cta' => [
+                'book' => 'Reservar',
+                'order' => 'Pedir online',
+                'shop' => 'Comprar',
+                'learn_more' => 'Más información',
+                'sign_up' => 'Registrarse',
+                'get_offer' => 'Canjear oferta',
+                'call' => 'Llamar ahora',
+            ],
+            'cta_url' => 'Enlace del botón',
+            'cta_url_placeholder' => 'https://example.com',
+            'event_title' => 'Título del evento',
+            'event_title_placeholder' => 'Venta de verano',
+            'event_title_required' => 'Ingresa un título de evento.',
+            'event_start_date' => 'Fecha de inicio',
+            'event_start_date_required' => 'Ingresa una fecha de inicio.',
+            'event_end_date' => 'Fecha de finalización',
+            'event_end_date_required' => 'Ingresa una fecha de finalización.',
+            'event_start_time' => 'Hora de inicio',
+            'event_end_time' => 'Hora de finalización',
+            'offer_coupon_code' => 'Código de cupón',
+            'offer_redeem_url' => 'Enlace para canjear online',
+            'offer_terms' => 'Términos y condiciones',
+        ],
         'warnings' => [
             'no_variant' => 'Elige un tipo de publicación para continuar.',
             'requires_media' => 'Este tipo requiere al menos una imagen o video.',
diff --git a/lang/fr/posts.php b/lang/fr/posts.php
index 69c09ab55..6c276b900 100644
--- a/lang/fr/posts.php
+++ b/lang/fr/posts.php
@@ -186,6 +186,41 @@
             'embed_image' => 'URL de l\'image',
             'embed_color' => 'Couleur',
         ],
+        'google_business' => [
+            'settings' => 'Paramètres de Google Business Profile',
+            'posting_to' => 'Publier sur',
+            'topic_type_label' => 'Type de publication',
+            'topic_type' => [
+                'standard' => 'Mise à jour',
+                'event' => 'Événement',
+                'offer' => 'Offre',
+            ],
+            'cta_label' => 'Bouton',
+            'cta_none' => 'Pas de bouton',
+            'cta' => [
+                'book' => 'Réserver',
+                'order' => 'Commander en ligne',
+                'shop' => 'Acheter',
+                'learn_more' => 'En savoir plus',
+                'sign_up' => 'S\'inscrire',
+                'get_offer' => 'Utiliser l\'offre',
+                'call' => 'Appelez maintenant',
+            ],
+            'cta_url' => 'Lien du bouton',
+            'cta_url_placeholder' => 'https://example.com',
+            'event_title' => 'Titre de l\'événement',
+            'event_title_placeholder' => 'Vente d\'été',
+            'event_title_required' => 'Entrez un titre d\'événement.',
+            'event_start_date' => 'Date de début',
+            'event_start_date_required' => 'Entrez une date de début.',
+            'event_end_date' => 'Date de fin',
+            'event_end_date_required' => 'Entrez une date de fin.',
+            'event_start_time' => 'Heure de début',
+            'event_end_time' => 'Heure de fin',
+            'offer_coupon_code' => 'Code de coupon',
+            'offer_redeem_url' => 'Lien de rachat en ligne',
+            'offer_terms' => 'Conditions et termes',
+        ],
         'warnings' => [
             'no_variant' => 'Choisissez un type de publication pour continuer.',
             'requires_media' => 'Ce type de publication nécessite au moins une image ou une vidéo.',
diff --git a/lang/it/posts.php b/lang/it/posts.php
index 60eb1cd2d..0b4012afc 100644
--- a/lang/it/posts.php
+++ b/lang/it/posts.php
@@ -186,6 +186,41 @@
             'embed_image' => 'URL immagine',
             'embed_color' => 'Colore',
         ],
+        'google_business' => [
+            'settings' => 'Impostazioni Google Business Profile',
+            'posting_to' => 'Pubblicazione su',
+            'topic_type_label' => 'Tipo di post',
+            'topic_type' => [
+                'standard' => 'Aggiornamento',
+                'event' => 'Evento',
+                'offer' => 'Offerta',
+            ],
+            'cta_label' => 'Pulsante',
+            'cta_none' => 'Nessun pulsante',
+            'cta' => [
+                'book' => 'Prenota',
+                'order' => 'Ordina online',
+                'shop' => 'Acquista',
+                'learn_more' => 'Scopri di più',
+                'sign_up' => 'Iscriviti',
+                'get_offer' => 'Riscatta offerta',
+                'call' => 'Chiama ora',
+            ],
+            'cta_url' => 'Link del pulsante',
+            'cta_url_placeholder' => 'https://example.com',
+            'event_title' => 'Titolo evento',
+            'event_title_placeholder' => 'Saldi estivi',
+            'event_title_required' => 'Inserisci un titolo evento.',
+            'event_start_date' => 'Data inizio',
+            'event_start_date_required' => 'Inserisci una data inizio.',
+            'event_end_date' => 'Data fine',
+            'event_end_date_required' => 'Inserisci una data fine.',
+            'event_start_time' => 'Ora inizio',
+            'event_end_time' => 'Ora fine',
+            'offer_coupon_code' => 'Codice coupon',
+            'offer_redeem_url' => 'Link riscatto online',
+            'offer_terms' => 'Termini e condizioni',
+        ],
         'warnings' => [
             'no_variant' => 'Scegli un tipo di post per continuare.',
             'requires_media' => 'Questo tipo di post richiede almeno un\'immagine o un video.',
diff --git a/lang/ja/posts.php b/lang/ja/posts.php
index 0d42cef6b..654191ee1 100644
--- a/lang/ja/posts.php
+++ b/lang/ja/posts.php
@@ -186,6 +186,41 @@
             'embed_image' => '画像 URL',
             'embed_color' => '色',
         ],
+        'google_business' => [
+            'settings' => 'Google Business Profile 設定',
+            'posting_to' => '投稿先',
+            'topic_type_label' => '投稿タイプ',
+            'topic_type' => [
+                'standard' => '更新',
+                'event' => 'イベント',
+                'offer' => 'オファー',
+            ],
+            'cta_label' => 'ボタン',
+            'cta_none' => 'ボタンなし',
+            'cta' => [
+                'book' => '予約',
+                'order' => 'オンラインで注文',
+                'shop' => '購入',
+                'learn_more' => 'もっと詳しく',
+                'sign_up' => '登録',
+                'get_offer' => 'オファーを利用',
+                'call' => '今すぐ電話',
+            ],
+            'cta_url' => 'ボタンリンク',
+            'cta_url_placeholder' => 'https://example.com',
+            'event_title' => 'イベントタイトル',
+            'event_title_placeholder' => '夏のセール',
+            'event_title_required' => 'イベントタイトルを入力してください。',
+            'event_start_date' => '開始日',
+            'event_start_date_required' => '開始日を入力してください。',
+            'event_end_date' => '終了日',
+            'event_end_date_required' => '終了日を入力してください。',
+            'event_start_time' => '開始時刻',
+            'event_end_time' => '終了時刻',
+            'offer_coupon_code' => 'クーポンコード',
+            'offer_redeem_url' => 'オンライン引き換えリンク',
+            'offer_terms' => '利用規約',
+        ],
         'warnings' => [
             'no_variant' => '続けるには投稿タイプを選択してください。',
             'requires_media' => 'この投稿タイプには少なくとも 1 つの画像または動画が必要です。',
diff --git a/lang/ko/posts.php b/lang/ko/posts.php
index 65670101d..d6648119e 100644
--- a/lang/ko/posts.php
+++ b/lang/ko/posts.php
@@ -186,6 +186,41 @@
             'embed_image' => '이미지 URL',
             'embed_color' => '색상',
         ],
+        'google_business' => [
+            'settings' => 'Google Business Profile 설정',
+            'posting_to' => '게시 대상',
+            'topic_type_label' => '게시물 유형',
+            'topic_type' => [
+                'standard' => '업데이트',
+                'event' => '이벤트',
+                'offer' => '오퍼',
+            ],
+            'cta_label' => '버튼',
+            'cta_none' => '버튼 없음',
+            'cta' => [
+                'book' => '예약',
+                'order' => '온라인 주문',
+                'shop' => '구매',
+                'learn_more' => '자세히 알아보기',
+                'sign_up' => '가입',
+                'get_offer' => '오퍼 받기',
+                'call' => '지금 전화',
+            ],
+            'cta_url' => '버튼 링크',
+            'cta_url_placeholder' => 'https://example.com',
+            'event_title' => '이벤트 제목',
+            'event_title_placeholder' => '여름 세일',
+            'event_title_required' => '이벤트 제목을 입력하세요.',
+            'event_start_date' => '시작 날짜',
+            'event_start_date_required' => '시작 날짜를 입력하세요.',
+            'event_end_date' => '종료 날짜',
+            'event_end_date_required' => '종료 날짜를 입력하세요.',
+            'event_start_time' => '시작 시간',
+            'event_end_time' => '종료 시간',
+            'offer_coupon_code' => '쿠폰 코드',
+            'offer_redeem_url' => '온라인 사용 링크',
+            'offer_terms' => '약관',
+        ],
         'warnings' => [
             'no_variant' => '계속하려면 게시물 유형을 선택하세요.',
             'requires_media' => '이 게시물 유형에는 이미지 또는 동영상이 하나 이상 필요합니다.',
diff --git a/lang/nl/posts.php b/lang/nl/posts.php
index 1c70e3972..5fbd00266 100644
--- a/lang/nl/posts.php
+++ b/lang/nl/posts.php
@@ -186,6 +186,41 @@
             'embed_image' => 'Afbeeldings-URL',
             'embed_color' => 'Kleur',
         ],
+        'google_business' => [
+            'settings' => 'Google Business Profile-instellingen',
+            'posting_to' => 'Posten naar',
+            'topic_type_label' => 'Posttype',
+            'topic_type' => [
+                'standard' => 'Update',
+                'event' => 'Evenement',
+                'offer' => 'Aanbod',
+            ],
+            'cta_label' => 'Knop',
+            'cta_none' => 'Geen knop',
+            'cta' => [
+                'book' => 'Boeken',
+                'order' => 'Online bestellen',
+                'shop' => 'Kopen',
+                'learn_more' => 'Meer informatie',
+                'sign_up' => 'Aanmelden',
+                'get_offer' => 'Aanbod gebruiken',
+                'call' => 'Nu bellen',
+            ],
+            'cta_url' => 'Koppelinformatie voor knop',
+            'cta_url_placeholder' => 'https://example.com',
+            'event_title' => 'Evenementtitel',
+            'event_title_placeholder' => 'Zomeruitverkoop',
+            'event_title_required' => 'Voer een evenementtitel in.',
+            'event_start_date' => 'Startdatum',
+            'event_start_date_required' => 'Voer een startdatum in.',
+            'event_end_date' => 'Einddatum',
+            'event_end_date_required' => 'Voer een einddatum in.',
+            'event_start_time' => 'Starttijd',
+            'event_end_time' => 'Eindtijd',
+            'offer_coupon_code' => 'Couponcode',
+            'offer_redeem_url' => 'Online inwisselingskoppeling',
+            'offer_terms' => 'Voorwaarden',
+        ],
         'warnings' => [
             'no_variant' => 'Kies een posttype om door te gaan.',
             'requires_media' => 'Dit posttype vereist ten minste één afbeelding of video.',
diff --git a/lang/pl/posts.php b/lang/pl/posts.php
index 79779b76b..c7736b9b0 100644
--- a/lang/pl/posts.php
+++ b/lang/pl/posts.php
@@ -186,6 +186,41 @@
             'embed_image' => 'Adres URL obrazu',
             'embed_color' => 'Kolor',
         ],
+        'google_business' => [
+            'settings' => 'Ustawienia Google Business Profile',
+            'posting_to' => 'Publikowanie na',
+            'topic_type_label' => 'Typ posta',
+            'topic_type' => [
+                'standard' => 'Aktualizacja',
+                'event' => 'Wydarzenie',
+                'offer' => 'Oferta',
+            ],
+            'cta_label' => 'Przycisk',
+            'cta_none' => 'Bez przycisku',
+            'cta' => [
+                'book' => 'Zarezerwuj',
+                'order' => 'Zamów online',
+                'shop' => 'Kup',
+                'learn_more' => 'Dowiedz się więcej',
+                'sign_up' => 'Zarejestruj się',
+                'get_offer' => 'Uzyskaj ofertę',
+                'call' => 'Zadzwoń teraz',
+            ],
+            'cta_url' => 'Link przycisku',
+            'cta_url_placeholder' => 'https://example.com',
+            'event_title' => 'Tytuł wydarzenia',
+            'event_title_placeholder' => 'Letnia wyprzedaż',
+            'event_title_required' => 'Wpisz tytuł wydarzenia.',
+            'event_start_date' => 'Data rozpoczęcia',
+            'event_start_date_required' => 'Wpisz datę rozpoczęcia.',
+            'event_end_date' => 'Data zakończenia',
+            'event_end_date_required' => 'Wpisz datę zakończenia.',
+            'event_start_time' => 'Czas rozpoczęcia',
+            'event_end_time' => 'Czas zakończenia',
+            'offer_coupon_code' => 'Kod kuponu',
+            'offer_redeem_url' => 'Link do realizacji online',
+            'offer_terms' => 'Warunki i postanowienia',
+        ],
         'warnings' => [
             'no_variant' => 'Wybierz typ posta, aby kontynuować.',
             'requires_media' => 'Ten typ posta wymaga co najmniej jednego obrazu lub filmu.',
diff --git a/lang/pt-BR/posts.php b/lang/pt-BR/posts.php
index 34a7029d1..8ffbc3a04 100644
--- a/lang/pt-BR/posts.php
+++ b/lang/pt-BR/posts.php
@@ -186,6 +186,41 @@
             'embed_image' => 'URL da imagem',
             'embed_color' => 'Cor',
         ],
+        'google_business' => [
+            'settings' => 'Configurações do Google Business Profile',
+            'posting_to' => 'Publicando em',
+            'topic_type_label' => 'Tipo de publicação',
+            'topic_type' => [
+                'standard' => 'Atualização',
+                'event' => 'Evento',
+                'offer' => 'Oferta',
+            ],
+            'cta_label' => 'Botão',
+            'cta_none' => 'Sem botão',
+            'cta' => [
+                'book' => 'Reservar',
+                'order' => 'Pedir online',
+                'shop' => 'Comprar',
+                'learn_more' => 'Saiba mais',
+                'sign_up' => 'Inscreva-se',
+                'get_offer' => 'Usar oferta',
+                'call' => 'Ligar agora',
+            ],
+            'cta_url' => 'Link do botão',
+            'cta_url_placeholder' => 'https://example.com',
+            'event_title' => 'Título do evento',
+            'event_title_placeholder' => 'Venda de verão',
+            'event_title_required' => 'Insira um título de evento.',
+            'event_start_date' => 'Data de início',
+            'event_start_date_required' => 'Insira uma data de início.',
+            'event_end_date' => 'Data de término',
+            'event_end_date_required' => 'Insira uma data de término.',
+            'event_start_time' => 'Hora de início',
+            'event_end_time' => 'Hora de término',
+            'offer_coupon_code' => 'Código do cupom',
+            'offer_redeem_url' => 'Link para resgatar online',
+            'offer_terms' => 'Termos e condições',
+        ],
         'warnings' => [
             'no_variant' => 'Escolha um tipo de publicação para continuar.',
             'requires_media' => 'Este tipo exige pelo menos uma imagem ou vídeo.',
diff --git a/lang/ru/posts.php b/lang/ru/posts.php
index d826a3ded..f7103b2be 100644
--- a/lang/ru/posts.php
+++ b/lang/ru/posts.php
@@ -186,6 +186,41 @@
             'embed_image' => 'URL изображения',
             'embed_color' => 'Цвет',
         ],
+        'google_business' => [
+            'settings' => 'Настройки Google Business Profile',
+            'posting_to' => 'Публикация в',
+            'topic_type_label' => 'Тип поста',
+            'topic_type' => [
+                'standard' => 'Обновление',
+                'event' => 'Событие',
+                'offer' => 'Предложение',
+            ],
+            'cta_label' => 'Кнопка',
+            'cta_none' => 'Без кнопки',
+            'cta' => [
+                'book' => 'Забронировать',
+                'order' => 'Заказать онлайн',
+                'shop' => 'Купить',
+                'learn_more' => 'Узнать больше',
+                'sign_up' => 'Зарегистрироваться',
+                'get_offer' => 'Получить предложение',
+                'call' => 'Позвонить сейчас',
+            ],
+            'cta_url' => 'Ссылка кнопки',
+            'cta_url_placeholder' => 'https://example.com',
+            'event_title' => 'Название события',
+            'event_title_placeholder' => 'Летняя распродажа',
+            'event_title_required' => 'Введите название события.',
+            'event_start_date' => 'Дата начала',
+            'event_start_date_required' => 'Введите дату начала.',
+            'event_end_date' => 'Дата окончания',
+            'event_end_date_required' => 'Введите дату окончания.',
+            'event_start_time' => 'Время начала',
+            'event_end_time' => 'Время окончания',
+            'offer_coupon_code' => 'Код купона',
+            'offer_redeem_url' => 'Ссылка на удаление в Интернете',
+            'offer_terms' => 'Условия использования',
+        ],
         'warnings' => [
             'no_variant' => 'Выберите тип поста, чтобы продолжить.',
             'requires_media' => 'Этот тип поста требует хотя бы одно изображение или видео.',
diff --git a/lang/tr/posts.php b/lang/tr/posts.php
index 0a39c1774..fa1c3f0b3 100644
--- a/lang/tr/posts.php
+++ b/lang/tr/posts.php
@@ -188,6 +188,41 @@
             'embed_image' => 'Görsel URL\'si',
             'embed_color' => 'Renk',
         ],
+        'google_business' => [
+            'settings' => 'Google Business Profile Ayarları',
+            'posting_to' => 'Şuraya paylaşılıyor',
+            'topic_type_label' => 'Gönderi türü',
+            'topic_type' => [
+                'standard' => 'Güncelleme',
+                'event' => 'Etkinlik',
+                'offer' => 'Teklif',
+            ],
+            'cta_label' => 'Düğme',
+            'cta_none' => 'Düğme yok',
+            'cta' => [
+                'book' => 'Rezervasyon',
+                'order' => 'Çevrimiçi sipariş',
+                'shop' => 'Satın al',
+                'learn_more' => 'Daha fazla bilgi',
+                'sign_up' => 'Kaydol',
+                'get_offer' => 'Teklifi al',
+                'call' => 'Hemen ara',
+            ],
+            'cta_url' => 'Düğme bağlantısı',
+            'cta_url_placeholder' => 'https://example.com',
+            'event_title' => 'Etkinlik başlığı',
+            'event_title_placeholder' => 'Yaz indirimi',
+            'event_title_required' => 'Bir etkinlik başlığı girin.',
+            'event_start_date' => 'Başlangıç tarihi',
+            'event_start_date_required' => 'Başlangıç tarihini girin.',
+            'event_end_date' => 'Bitiş tarihi',
+            'event_end_date_required' => 'Bitiş tarihini girin.',
+            'event_start_time' => 'Başlangıç saati',
+            'event_end_time' => 'Bitiş saati',
+            'offer_coupon_code' => 'Kupon kodu',
+            'offer_redeem_url' => 'Çevrimiçi kullanım bağlantısı',
+            'offer_terms' => 'Şartlar ve koşullar',
+        ],
         'warnings' => [
             'no_variant' => 'Devam etmek için bir gönderi türü seçin.',
             'requires_media' => 'Bu gönderi türü en az bir görsel veya video gerektirir.',
diff --git a/lang/uk/posts.php b/lang/uk/posts.php
index 7ff1b27bf..a0727d89b 100644
--- a/lang/uk/posts.php
+++ b/lang/uk/posts.php
@@ -186,6 +186,41 @@
             'embed_image' => 'URL зображення',
             'embed_color' => 'Колір',
         ],
+        'google_business' => [
+            'settings' => 'Налаштування Google Business Profile',
+            'posting_to' => 'Публікація в',
+            'topic_type_label' => 'Тип посту',
+            'topic_type' => [
+                'standard' => 'Оновлення',
+                'event' => 'Подія',
+                'offer' => 'Пропозиція',
+            ],
+            'cta_label' => 'Кнопка',
+            'cta_none' => 'Без кнопки',
+            'cta' => [
+                'book' => 'Забронювати',
+                'order' => 'Замовити онлайн',
+                'shop' => 'Купити',
+                'learn_more' => 'Дізнатись більше',
+                'sign_up' => 'Зареєструватися',
+                'get_offer' => 'Отримати пропозицію',
+                'call' => 'Позвонити зараз',
+            ],
+            'cta_url' => 'Посилання кнопки',
+            'cta_url_placeholder' => 'https://example.com',
+            'event_title' => 'Назва події',
+            'event_title_placeholder' => 'Літній розпродаж',
+            'event_title_required' => 'Введіть назву події.',
+            'event_start_date' => 'Дата початку',
+            'event_start_date_required' => 'Введіть дату початку.',
+            'event_end_date' => 'Дата завершення',
+            'event_end_date_required' => 'Введіть дату завершення.',
+            'event_start_time' => 'Час початку',
+            'event_end_time' => 'Час завершення',
+            'offer_coupon_code' => 'Код купона',
+            'offer_redeem_url' => 'Посилання на реалізацію онлайн',
+            'offer_terms' => 'Умови та положення',
+        ],
         'warnings' => [
             'no_variant' => 'Виберіть тип поста, щоб продовжити.',
             'requires_media' => 'Цей тип поста потребує принаймні одного зображення або відео.',
diff --git a/lang/zh/posts.php b/lang/zh/posts.php
index 39482adbd..c3ca66317 100644
--- a/lang/zh/posts.php
+++ b/lang/zh/posts.php
@@ -186,6 +186,41 @@
             'embed_image' => '图片 URL',
             'embed_color' => '颜色',
         ],
+        'google_business' => [
+            'settings' => 'Google Business Profile 设置',
+            'posting_to' => '发布到',
+            'topic_type_label' => '帖子类型',
+            'topic_type' => [
+                'standard' => '更新',
+                'event' => '活动',
+                'offer' => '优惠',
+            ],
+            'cta_label' => '按钮',
+            'cta_none' => '无按钮',
+            'cta' => [
+                'book' => '预订',
+                'order' => '在线订购',
+                'shop' => '购买',
+                'learn_more' => '了解详情',
+                'sign_up' => '注册',
+                'get_offer' => '获取优惠',
+                'call' => '立即致电',
+            ],
+            'cta_url' => '按钮链接',
+            'cta_url_placeholder' => 'https://example.com',
+            'event_title' => '活动标题',
+            'event_title_placeholder' => '夏季促销',
+            'event_title_required' => '请输入活动标题。',
+            'event_start_date' => '开始日期',
+            'event_start_date_required' => '请输入开始日期。',
+            'event_end_date' => '结束日期',
+            'event_end_date_required' => '请输入结束日期。',
+            'event_start_time' => '开始时间',
+            'event_end_time' => '结束时间',
+            'offer_coupon_code' => '优惠券代码',
+            'offer_redeem_url' => '在线兑换链接',
+            'offer_terms' => '条款和条件',
+        ],
         'warnings' => [
             'no_variant' => '请选择一个帖子类型以继续。',
             'requires_media' => '此帖子类型至少需要一张图片或一个视频。',
diff --git a/tests/Unit/PostPlatformMetaRulesTest.php b/tests/Unit/PostPlatformMetaRulesTest.php
index f3af6ec52..f3869f592 100644
--- a/tests/Unit/PostPlatformMetaRulesTest.php
+++ b/tests/Unit/PostPlatformMetaRulesTest.php
@@ -2,7 +2,9 @@
 
 declare(strict_types=1);
 
+use App\Enums\SocialAccount\Platform;
 use App\Support\PostPlatformMetaRules;
+use ReflectionMethod;
 
 test('custom meta messages only cover pinterest title and link', function () {
     expect(PostPlatformMetaRules::messages())->toBe([
@@ -16,6 +18,8 @@
     expect(PostPlatformMetaRules::attributes())->toBe([
         'platforms.*.meta.title' => __('posts.form.pinterest.title'),
         'platforms.*.meta.link' => __('posts.form.pinterest.link'),
+        'platforms.*.meta.event.title' => __('posts.form.google_business.event_title'),
+        'platforms.*.meta.call_to_action.url' => __('posts.form.google_business.cta_url'),
     ]);
 });
 
@@ -31,3 +35,38 @@
         'platforms.*.meta.link',
     ]);
 });
+
+test('google business event topic type requires event title, start date, and end date to publish', function () {
+    $violation = (new ReflectionMethod(PostPlatformMetaRules::class, 'requiredMetaViolation'))
+        ->invoke(null, Platform::GoogleBusiness, ['topic_type' => 'EVENT']);
+
+    expect($violation)->not->toBeNull();
+    expect($violation[0])->toBe('event.title');
+});
+
+test('google business standard topic type has no required meta', function () {
+    $violation = (new ReflectionMethod(PostPlatformMetaRules::class, 'requiredMetaViolation'))
+        ->invoke(null, Platform::GoogleBusiness, ['topic_type' => 'STANDARD']);
+
+    expect($violation)->toBeNull();
+});
+
+test('google business event topic type with all fields present has no violation', function () {
+    $violation = (new ReflectionMethod(PostPlatformMetaRules::class, 'requiredMetaViolation'))
+        ->invoke(null, Platform::GoogleBusiness, [
+            'topic_type' => 'EVENT',
+            'event' => ['title' => 'Sale', 'start_date' => '2026-09-01', 'end_date' => '2026-09-02'],
+        ]);
+
+    expect($violation)->toBeNull();
+});
+
+test('google business meta rules validate topic_type and call_to_action shape', function () {
+    $rules = PostPlatformMetaRules::rules();
+
+    expect($rules)->toHaveKey('platforms.*.meta.topic_type');
+    expect($rules)->toHaveKey('platforms.*.meta.call_to_action.action_type');
+    expect($rules)->toHaveKey('platforms.*.meta.call_to_action.url');
+    expect($rules)->toHaveKey('platforms.*.meta.event.title');
+    expect($rules)->toHaveKey('platforms.*.meta.offer.coupon_code');
+});

From 6687f833a31505f672a0b05bd8969531d36c1ace Mon Sep 17 00:00:00 2001
From: Paulo Castellano <paulo@castellanos.llc>
Date: Mon, 10 Aug 2026 23:07:53 -0300
Subject: [PATCH 04/47] feat: add GoogleBusinessPublishException error mapping

---
 .../Social/GoogleBusinessPublishException.php | 96 +++++++++++++++++++
 .../GoogleBusinessPublishExceptionTest.php    | 72 ++++++++++++++
 2 files changed, 168 insertions(+)
 create mode 100644 app/Exceptions/Social/GoogleBusinessPublishException.php
 create mode 100644 tests/Unit/Exceptions/Social/GoogleBusinessPublishExceptionTest.php

diff --git a/app/Exceptions/Social/GoogleBusinessPublishException.php b/app/Exceptions/Social/GoogleBusinessPublishException.php
new file mode 100644
index 000000000..001c4f409
--- /dev/null
+++ b/app/Exceptions/Social/GoogleBusinessPublishException.php
@@ -0,0 +1,96 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Exceptions\Social;
+
+use App\Exceptions\TokenExpiredException;
+use Illuminate\Http\Client\Response;
+
+class GoogleBusinessPublishException extends SocialPublishException
+{
+    public static function fromApiResponse(mixed $response): static
+    {
+        /** @var Response $response */
+        $status = $response->status();
+        $reason = (string) data_get($response->json(), 'error.status', '');
+        $message = (string) data_get($response->json(), 'error.message', '');
+        $rawResponse = $response->body();
+
+        if (self::isConfirmedDeadToken($response)) {
+            throw new TokenExpiredException(
+                message: $message !== '' ? $message : 'Google Business Profile access token has expired or been revoked',
+                platformErrorCode: $reason !== '' ? $reason : (string) $status,
+            );
+        }
+
+        if ($reason === 'PERMISSION_DENIED') {
+            return new static(
+                userMessage: 'Permission denied. Please reconnect and confirm access to this business location.',
+                category: ErrorCategory::Permission,
+                platformErrorCode: $reason,
+                rawResponse: $rawResponse,
+            );
+        }
+
+        if ($reason === 'NOT_FOUND') {
+            return new static(
+                userMessage: 'Business location not found. It may have been deleted — please reconnect.',
+                category: ErrorCategory::ContentPolicy,
+                platformErrorCode: $reason,
+                rawResponse: $rawResponse,
+            );
+        }
+
+        if ($reason === 'INVALID_ARGUMENT') {
+            return new static(
+                userMessage: $message !== '' ? $message : 'Invalid post content. Please check your post details.',
+                category: ErrorCategory::ContentPolicy,
+                platformErrorCode: $reason,
+                rawResponse: $rawResponse,
+            );
+        }
+
+        if ($reason === 'RESOURCE_EXHAUSTED' || $status === 429) {
+            return new static(
+                userMessage: 'Rate limit exceeded. Please try again later.',
+                category: ErrorCategory::RateLimit,
+                platformErrorCode: $reason !== '' ? $reason : (string) $status,
+                rawResponse: $rawResponse,
+            );
+        }
+
+        if ($status >= 500) {
+            return new static(
+                userMessage: 'Google Business Profile server error. Please try again.',
+                category: ErrorCategory::ServerError,
+                platformErrorCode: (string) $status,
+                rawResponse: $rawResponse,
+            );
+        }
+
+        return new static(
+            userMessage: $message !== '' ? $message : $rawResponse,
+            category: ErrorCategory::Unknown,
+            platformErrorCode: $reason !== '' ? $reason : (string) $status,
+            rawResponse: $rawResponse,
+        );
+    }
+
+    public function platform(): string
+    {
+        return 'google_business';
+    }
+
+    /**
+     * Whether this response confirms the account's own access_token is dead
+     * (not merely a transient or content-specific failure). Shared with
+     * ConnectionVerifier so both the publish and verify paths agree on what
+     * a dead Google Business Profile token looks like.
+     */
+    public static function isConfirmedDeadToken(Response $response): bool
+    {
+        return $response->status() === 401
+            || data_get($response->json(), 'error.status') === 'UNAUTHENTICATED';
+    }
+}
diff --git a/tests/Unit/Exceptions/Social/GoogleBusinessPublishExceptionTest.php b/tests/Unit/Exceptions/Social/GoogleBusinessPublishExceptionTest.php
new file mode 100644
index 000000000..7c833039f
--- /dev/null
+++ b/tests/Unit/Exceptions/Social/GoogleBusinessPublishExceptionTest.php
@@ -0,0 +1,72 @@
+<?php
+
+declare(strict_types=1);
+
+use App\Exceptions\Social\ErrorCategory;
+use App\Exceptions\Social\GoogleBusinessPublishException;
+use App\Exceptions\TokenExpiredException;
+use Illuminate\Support\Facades\Http;
+
+test('unauthenticated status throws a token expired exception', function () {
+    $response = Http::response(['error' => ['status' => 'UNAUTHENTICATED', 'message' => 'bad token']], 401);
+    $fakeResponse = Http::fake(['*' => $response])->post('https://mybusinessaccountmanagement.googleapis.com/test');
+
+    GoogleBusinessPublishException::fromApiResponse($fakeResponse);
+})->throws(TokenExpiredException::class);
+
+test('permission denied maps to the permission category', function () {
+    $response = Http::response(['error' => ['status' => 'PERMISSION_DENIED', 'message' => 'no access']], 403);
+    $fakeResponse = Http::fake(['*' => $response])->post('https://mybusinessaccountmanagement.googleapis.com/test');
+
+    $exception = GoogleBusinessPublishException::fromApiResponse($fakeResponse);
+
+    expect($exception->category)->toBe(ErrorCategory::Permission);
+});
+
+test('not found maps to the content policy category', function () {
+    $response = Http::response(['error' => ['status' => 'NOT_FOUND', 'message' => 'location gone']], 404);
+    $fakeResponse = Http::fake(['*' => $response])->post('https://mybusinessaccountmanagement.googleapis.com/test');
+
+    $exception = GoogleBusinessPublishException::fromApiResponse($fakeResponse);
+
+    expect($exception->category)->toBe(ErrorCategory::ContentPolicy);
+});
+
+test('resource exhausted maps to the rate limit category', function () {
+    $response = Http::response(['error' => ['status' => 'RESOURCE_EXHAUSTED', 'message' => 'slow down']], 429);
+    $fakeResponse = Http::fake(['*' => $response])->post('https://mybusinessaccountmanagement.googleapis.com/test');
+
+    $exception = GoogleBusinessPublishException::fromApiResponse($fakeResponse);
+
+    expect($exception->category)->toBe(ErrorCategory::RateLimit);
+});
+
+test('500 status maps to the server error category', function () {
+    $response = Http::response(['error' => ['status' => 'INTERNAL', 'message' => 'oops']], 500);
+    $fakeResponse = Http::fake(['*' => $response])->post('https://mybusinessaccountmanagement.googleapis.com/test');
+
+    $exception = GoogleBusinessPublishException::fromApiResponse($fakeResponse);
+
+    expect($exception->category)->toBe(ErrorCategory::ServerError);
+});
+
+test('isConfirmedDeadToken is true for 401 status', function () {
+    $response = Http::response([], 401);
+    $fakeResponse = Http::fake(['*' => $response])->post('https://mybusinessaccountmanagement.googleapis.com/test');
+
+    expect(GoogleBusinessPublishException::isConfirmedDeadToken($fakeResponse))->toBeTrue();
+});
+
+test('isConfirmedDeadToken is true for UNAUTHENTICATED status', function () {
+    $response = Http::response(['error' => ['status' => 'UNAUTHENTICATED']], 400);
+    $fakeResponse = Http::fake(['*' => $response])->post('https://mybusinessaccountmanagement.googleapis.com/test');
+
+    expect(GoogleBusinessPublishException::isConfirmedDeadToken($fakeResponse))->toBeTrue();
+});
+
+test('isConfirmedDeadToken is false for PERMISSION_DENIED status', function () {
+    $response = Http::response(['error' => ['status' => 'PERMISSION_DENIED']], 403);
+    $fakeResponse = Http::fake(['*' => $response])->post('https://mybusinessaccountmanagement.googleapis.com/test');
+
+    expect(GoogleBusinessPublishException::isConfirmedDeadToken($fakeResponse))->toBeFalse();
+});

From 823ffc8ba65a04c3ac59daa51ea24b51f3673502 Mon Sep 17 00:00:00 2001
From: Paulo Castellano <paulo@castellanos.llc>
Date: Mon, 10 Aug 2026 23:11:00 -0300
Subject: [PATCH 05/47] test: add missing INVALID_ARGUMENT error mapping test

---
 .../Social/GoogleBusinessPublishExceptionTest.php      | 10 ++++++++++
 1 file changed, 10 insertions(+)

diff --git a/tests/Unit/Exceptions/Social/GoogleBusinessPublishExceptionTest.php b/tests/Unit/Exceptions/Social/GoogleBusinessPublishExceptionTest.php
index 7c833039f..8c860dcc6 100644
--- a/tests/Unit/Exceptions/Social/GoogleBusinessPublishExceptionTest.php
+++ b/tests/Unit/Exceptions/Social/GoogleBusinessPublishExceptionTest.php
@@ -32,6 +32,16 @@
     expect($exception->category)->toBe(ErrorCategory::ContentPolicy);
 });
 
+test('invalid argument maps to the content policy category', function () {
+    $response = Http::response(['error' => ['status' => 'INVALID_ARGUMENT', 'message' => 'Invalid post format']], 400);
+    $fakeResponse = Http::fake(['*' => $response])->post('https://mybusinessaccountmanagement.googleapis.com/test');
+
+    $exception = GoogleBusinessPublishException::fromApiResponse($fakeResponse);
+
+    expect($exception->category)->toBe(ErrorCategory::ContentPolicy)
+        ->and($exception->userMessage)->toBe('Invalid post format');
+});
+
 test('resource exhausted maps to the rate limit category', function () {
     $response = Http::response(['error' => ['status' => 'RESOURCE_EXHAUSTED', 'message' => 'slow down']], 429);
     $fakeResponse = Http::fake(['*' => $response])->post('https://mybusinessaccountmanagement.googleapis.com/test');

From 89081debfb49e63a2e3c96f90ac88b327dd886e7 Mon Sep 17 00:00:00 2001
From: Paulo Castellano <paulo@castellanos.llc>
Date: Mon, 10 Aug 2026 23:18:00 -0300
Subject: [PATCH 06/47] feat: add GoogleBusinessPublisher for Local Post
 publishing

---
 .../Social/GoogleBusinessPublisher.php        | 311 ++++++++++++++++++
 .../Social/GoogleBusinessPublisherTest.php    | 188 +++++++++++
 2 files changed, 499 insertions(+)
 create mode 100644 app/Services/Social/GoogleBusinessPublisher.php
 create mode 100644 tests/Feature/Services/Social/GoogleBusinessPublisherTest.php

diff --git a/app/Services/Social/GoogleBusinessPublisher.php b/app/Services/Social/GoogleBusinessPublisher.php
new file mode 100644
index 000000000..230eb74fc
--- /dev/null
+++ b/app/Services/Social/GoogleBusinessPublisher.php
@@ -0,0 +1,311 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Services\Social;
+
+use App\Enums\SocialAccount\Platform;
+use App\Enums\Workspace\ContentLanguage;
+use App\Exceptions\Social\ErrorCategory;
+use App\Exceptions\Social\GoogleBusinessPublishException;
+use App\Models\PostPlatform;
+use App\Models\SocialAccount;
+use App\Services\Social\Concerns\HasSocialHttpClient;
+use Carbon\CarbonImmutable;
+use Illuminate\Http\Client\Response;
+use Illuminate\Support\Facades\Log;
+
+class GoogleBusinessPublisher
+{
+    use HasSocialHttpClient;
+
+    private string $accountManagementUrl;
+
+    private string $businessInformationUrl;
+
+    private string $localPostsUrl;
+
+    public function __construct()
+    {
+        $this->accountManagementUrl = config('trypost.platforms.google_business.account_management_api');
+        $this->businessInformationUrl = config('trypost.platforms.google_business.business_information_api');
+        $this->localPostsUrl = config('trypost.platforms.google_business.local_posts_api');
+    }
+
+    public function publish(PostPlatform $postPlatform): array
+    {
+        $this->validateContentLength($postPlatform);
+
+        $account = $postPlatform->socialAccount;
+
+        if ($account->needsProactiveTokenRefresh()) {
+            app(ConnectionVerifier::class)->refreshToken($account);
+        }
+
+        $content = $postPlatform->post->content
+            ? app(ContentSanitizer::class)->sanitize($postPlatform->post->content, Platform::GoogleBusiness)
+            : '';
+
+        $locationId = (string) data_get($account->meta, 'location_id');
+
+        if (blank($locationId)) {
+            throw new GoogleBusinessPublishException(
+                userMessage: 'This Google Business Profile account has no location configured. Please reconnect it.',
+                category: ErrorCategory::Permission,
+            );
+        }
+
+        $payload = $this->buildPayload($postPlatform, $content);
+
+        $response = $this->socialHttp()->withToken($account->access_token)
+            ->post("{$this->localPostsUrl}/{$locationId}/localPosts", $payload);
+
+        if ($response->failed()) {
+            Log::error('Google Business Profile post creation failed', [
+                'status' => $response->status(),
+                'body' => $this->redactResponseBody($response->body()),
+            ]);
+            $this->handleApiError($response);
+        }
+
+        $postName = (string) data_get($response->json(), 'name');
+
+        return [
+            'id' => $postName,
+            'url' => 'https://business.google.com/locations/'.$this->shortLocationId($locationId),
+        ];
+    }
+
+    /**
+     * @return list<array{id: string, account_name: string, location_name: string, title: string, address: ?string}>
+     */
+    public function fetchLocations(string $accessToken): array
+    {
+        $locations = [];
+
+        foreach ($this->fetchAccounts($accessToken) as $accountName) {
+            array_push($locations, ...$this->fetchLocationsForAccount($accessToken, $accountName));
+        }
+
+        return $locations;
+    }
+
+    /**
+     * @return list<array{id: string, account_name: string, location_name: string, title: string, address: ?string}>
+     */
+    public function getLocations(SocialAccount $account): array
+    {
+        if ($account->needsProactiveTokenRefresh()) {
+            app(ConnectionVerifier::class)->refreshToken($account);
+        }
+
+        return $this->fetchLocations($account->access_token);
+    }
+
+    /**
+     * @return array{id: string, account_name: string, location_name: string, title: string, address: ?string}
+     */
+    private function buildPayload(PostPlatform $postPlatform, string $content): array
+    {
+        $languageCode = $postPlatform->post->workspace->content_language ?? ContentLanguage::DEFAULT->value;
+        $topicType = (string) data_get($postPlatform->meta, 'topic_type', 'STANDARD');
+
+        $payload = [
+            'languageCode' => $languageCode,
+            'summary' => $content,
+            'topicType' => $topicType,
+        ];
+
+        $callToActionType = data_get($postPlatform->meta, 'call_to_action.action_type');
+
+        if (filled($callToActionType) && $callToActionType !== 'NONE') {
+            $callToAction = ['actionType' => $callToActionType];
+
+            if ($callToActionType !== 'CALL') {
+                $callToAction['url'] = data_get($postPlatform->meta, 'call_to_action.url');
+            }
+
+            $payload['callToAction'] = $callToAction;
+        }
+
+        $media = $postPlatform->post->mediaItems->first(fn ($item) => $item->isImage());
+
+        if ($media) {
+            $payload['media'] = [[
+                'mediaFormat' => 'PHOTO',
+                'sourceUrl' => $media->url,
+            ]];
+        }
+
+        if ($topicType === 'EVENT') {
+            $payload['event'] = $this->buildEvent($postPlatform);
+        }
+
+        if ($topicType === 'OFFER') {
+            $offer = $this->buildOffer($postPlatform);
+
+            if ($offer !== []) {
+                $payload['offer'] = $offer;
+            }
+        }
+
+        return $payload;
+    }
+
+    private function buildEvent(PostPlatform $postPlatform): array
+    {
+        $schedule = [
+            'startDate' => $this->formatDate((string) data_get($postPlatform->meta, 'event.start_date')),
+            'endDate' => $this->formatDate((string) data_get($postPlatform->meta, 'event.end_date')),
+        ];
+
+        if (filled(data_get($postPlatform->meta, 'event.start_time'))) {
+            $schedule['startTime'] = $this->formatTime((string) data_get($postPlatform->meta, 'event.start_time'));
+        }
+
+        if (filled(data_get($postPlatform->meta, 'event.end_time'))) {
+            $schedule['endTime'] = $this->formatTime((string) data_get($postPlatform->meta, 'event.end_time'));
+        }
+
+        return [
+            'title' => (string) data_get($postPlatform->meta, 'event.title'),
+            'schedule' => $schedule,
+        ];
+    }
+
+    private function buildOffer(PostPlatform $postPlatform): array
+    {
+        return array_filter([
+            'couponCode' => data_get($postPlatform->meta, 'offer.coupon_code'),
+            'redeemOnlineUrl' => data_get($postPlatform->meta, 'offer.redeem_online_url'),
+            'termsConditions' => data_get($postPlatform->meta, 'offer.terms_conditions'),
+        ], fn ($value) => filled($value));
+    }
+
+    /**
+     * @return array{year: int, month: int, day: int}
+     */
+    private function formatDate(string $date): array
+    {
+        $carbon = CarbonImmutable::parse($date);
+
+        return ['year' => (int) $carbon->format('Y'), 'month' => (int) $carbon->format('n'), 'day' => (int) $carbon->format('j')];
+    }
+
+    /**
+     * @return array{hours: int, minutes: int, seconds: int, nanos: int}
+     */
+    private function formatTime(string $time): array
+    {
+        $carbon = CarbonImmutable::parse($time);
+
+        return ['hours' => (int) $carbon->format('G'), 'minutes' => (int) $carbon->format('i'), 'seconds' => 0, 'nanos' => 0];
+    }
+
+    /**
+     * Google's `locations/{id}` full resource name → the bare numeric id used
+     * in the dashboard link, matching postiz's synthesized URL shape.
+     */
+    private function shortLocationId(string $locationId): string
+    {
+        $segments = explode('/', $locationId);
+
+        return end($segments);
+    }
+
+    /**
+     * @return list<string> Full "accounts/{id}" resource names.
+     */
+    private function fetchAccounts(string $accessToken): array
+    {
+        $accounts = [];
+        $pageToken = null;
+
+        do {
+            $response = $this->socialHttp()->withToken($accessToken)
+                ->get("{$this->accountManagementUrl}/accounts", array_filter([
+                    'pageSize' => 100,
+                    'pageToken' => $pageToken,
+                ]));
+
+            if ($response->failed()) {
+                Log::error('Google Business Profile accounts fetch failed', [
+                    'status' => $response->status(),
+                    'body' => $this->redactResponseBody($response->body()),
+                ]);
+                $this->handleApiError($response);
+            }
+
+            $data = $response->json() ?? [];
+
+            foreach (data_get($data, 'accounts', []) as $account) {
+                $accounts[] = (string) data_get($account, 'name');
+            }
+
+            $pageToken = data_get($data, 'nextPageToken');
+        } while (filled($pageToken));
+
+        return $accounts;
+    }
+
+    /**
+     * @return list<array{id: string, account_name: string, location_name: string, title: string, address: ?string}>
+     */
+    private function fetchLocationsForAccount(string $accessToken, string $accountName): array
+    {
+        $locations = [];
+        $pageToken = null;
+
+        do {
+            $response = $this->socialHttp()->withToken($accessToken)
+                ->get("{$this->businessInformationUrl}/{$accountName}/locations", array_filter([
+                    'readMask' => 'name,title,storefrontAddress,metadata',
+                    'pageSize' => 100,
+                    'pageToken' => $pageToken,
+                ]));
+
+            if ($response->failed()) {
+                Log::error('Google Business Profile locations fetch failed', [
+                    'account' => $accountName,
+                    'status' => $response->status(),
+                    'body' => $this->redactResponseBody($response->body()),
+                ]);
+                $this->handleApiError($response);
+            }
+
+            $data = $response->json() ?? [];
+
+            foreach (data_get($data, 'locations', []) as $location) {
+                $locations[] = [
+                    'id' => (string) data_get($location, 'name'),
+                    'account_name' => $accountName,
+                    'location_name' => (string) data_get($location, 'name'),
+                    'title' => (string) data_get($location, 'title'),
+                    'address' => $this->formatAddress(data_get($location, 'storefrontAddress')),
+                ];
+            }
+
+            $pageToken = data_get($data, 'nextPageToken');
+        } while (filled($pageToken));
+
+        return $locations;
+    }
+
+    private function formatAddress(?array $storefrontAddress): ?string
+    {
+        if (! $storefrontAddress) {
+            return null;
+        }
+
+        $lines = (array) data_get($storefrontAddress, 'addressLines', []);
+        $locality = data_get($storefrontAddress, 'locality');
+        $parts = array_filter([implode(' ', $lines), $locality]);
+
+        return $parts === [] ? null : implode(', ', $parts);
+    }
+
+    private function handleApiError(Response $response): never
+    {
+        throw GoogleBusinessPublishException::fromApiResponse($response);
+    }
+}
diff --git a/tests/Feature/Services/Social/GoogleBusinessPublisherTest.php b/tests/Feature/Services/Social/GoogleBusinessPublisherTest.php
new file mode 100644
index 000000000..4cbeaa8b9
--- /dev/null
+++ b/tests/Feature/Services/Social/GoogleBusinessPublisherTest.php
@@ -0,0 +1,188 @@
+<?php
+
+declare(strict_types=1);
+
+use App\Enums\PostPlatform\ContentType;
+use App\Enums\SocialAccount\Platform;
+use App\Exceptions\Social\GoogleBusinessPublishException;
+use App\Models\Post;
+use App\Models\PostPlatform;
+use App\Models\SocialAccount;
+use App\Models\User;
+use App\Models\Workspace;
+use App\Services\Social\GoogleBusinessPublisher;
+use Illuminate\Support\Facades\Http;
+
+beforeEach(function () {
+    $this->user = User::factory()->create();
+    $this->workspace = Workspace::factory()->create(['user_id' => $this->user->id, 'content_language' => 'en']);
+
+    $this->socialAccount = SocialAccount::factory()->googleBusiness()->create([
+        'workspace_id' => $this->workspace->id,
+        'platform_user_id' => 'accounts/123456789/locations/987654321',
+        'token_expires_at' => now()->addHour(),
+    ]);
+
+    $this->post = Post::factory()->create([
+        'workspace_id' => $this->workspace->id,
+        'user_id' => $this->user->id,
+        'content' => 'Check out our new arrivals!',
+    ]);
+
+    $this->postPlatform = PostPlatform::factory()->googleBusiness()->create([
+        'post_id' => $this->post->id,
+        'social_account_id' => $this->socialAccount->id,
+        'platform' => Platform::GoogleBusiness,
+        'content_type' => ContentType::GoogleBusinessPost,
+        'meta' => ['topic_type' => 'STANDARD'],
+    ]);
+
+    $this->publisher = new GoogleBusinessPublisher;
+});
+
+test('publishes a standard post with the workspace content language', function () {
+    Http::fake([
+        config('trypost.platforms.google_business.local_posts_api').'/*' => Http::response([
+            'name' => 'accounts/123456789/locations/987654321/localPosts/999',
+        ], 200),
+    ]);
+
+    $result = $this->publisher->publish($this->postPlatform);
+
+    expect($result['id'])->toBe('accounts/123456789/locations/987654321/localPosts/999');
+    expect($result['url'])->toBe('https://business.google.com/locations/987654321');
+
+    Http::assertSent(function ($request) {
+        return $request->url() === config('trypost.platforms.google_business.local_posts_api').'/accounts/123456789/locations/987654321/localPosts'
+            && $request['languageCode'] === 'en'
+            && $request['summary'] === 'Check out our new arrivals!'
+            && $request['topicType'] === 'STANDARD'
+            && ! isset($request['media']);
+    });
+});
+
+test('includes a call to action when configured', function () {
+    Http::fake([
+        config('trypost.platforms.google_business.local_posts_api').'/*' => Http::response(['name' => 'x'], 200),
+    ]);
+
+    $this->postPlatform->update([
+        'meta' => ['topic_type' => 'STANDARD', 'call_to_action' => ['action_type' => 'BOOK', 'url' => 'https://example.com/book']],
+    ]);
+
+    $this->publisher->publish($this->postPlatform->fresh());
+
+    Http::assertSent(fn ($request) => data_get($request->data(), 'callToAction') === ['actionType' => 'BOOK', 'url' => 'https://example.com/book']);
+});
+
+test('call omits the url even when one is stored', function () {
+    Http::fake([
+        config('trypost.platforms.google_business.local_posts_api').'/*' => Http::response(['name' => 'x'], 200),
+    ]);
+
+    $this->postPlatform->update([
+        'meta' => ['topic_type' => 'STANDARD', 'call_to_action' => ['action_type' => 'CALL', 'url' => null]],
+    ]);
+
+    $this->publisher->publish($this->postPlatform->fresh());
+
+    Http::assertSent(fn ($request) => data_get($request->data(), 'callToAction') === ['actionType' => 'CALL']);
+});
+
+test('builds an event payload for EVENT topic type', function () {
+    Http::fake([
+        config('trypost.platforms.google_business.local_posts_api').'/*' => Http::response(['name' => 'x'], 200),
+    ]);
+
+    $this->postPlatform->update([
+        'meta' => [
+            'topic_type' => 'EVENT',
+            'event' => ['title' => 'Grand Opening', 'start_date' => '2026-09-01', 'end_date' => '2026-09-02'],
+        ],
+    ]);
+
+    $this->publisher->publish($this->postPlatform->fresh());
+
+    Http::assertSent(function ($request) {
+        $event = data_get($request->data(), 'event');
+
+        return $event['title'] === 'Grand Opening'
+            && $event['schedule']['startDate'] === ['year' => 2026, 'month' => 9, 'day' => 1]
+            && $event['schedule']['endDate'] === ['year' => 2026, 'month' => 9, 'day' => 2];
+    });
+});
+
+test('rejects video media for google business posts', function () {
+    $this->post->update([
+        'media' => [[
+            'id' => 'test-media-id',
+            'path' => 'media/2026-01/video.mp4',
+            'url' => 'https://example.com/media/2026-01/video.mp4',
+            'mime_type' => 'video/mp4',
+            'original_filename' => 'video.mp4',
+        ]],
+    ]);
+
+    Http::fake([
+        config('trypost.platforms.google_business.local_posts_api').'/*' => Http::response(['name' => 'x'], 200),
+    ]);
+
+    $this->publisher->publish($this->postPlatform->fresh());
+
+    // Only a PHOTO mediaFormat is ever sent — video attachments are silently
+    // excluded here because ContentType::GoogleBusinessPost::supportsVideo()
+    // is false, so the editor's own validation already blocks scheduling one;
+    // this assertion is the backend's defense-in-depth for that same rule.
+    Http::assertSent(fn ($request) => ! isset($request['media']) || data_get($request->data(), 'media.0.mediaFormat') !== 'VIDEO');
+});
+
+test('throws a structured exception on API failure', function () {
+    Http::fake([
+        config('trypost.platforms.google_business.local_posts_api').'/*' => Http::response([
+            'error' => ['status' => 'INVALID_ARGUMENT', 'message' => 'summary too long'],
+        ], 400),
+    ]);
+
+    expect(fn () => $this->publisher->publish($this->postPlatform))
+        ->toThrow(GoogleBusinessPublishException::class, 'summary too long');
+});
+
+test('fetchLocations flattens accounts and locations across pages', function () {
+    Http::fake([
+        config('trypost.platforms.google_business.account_management_api').'/accounts*' => Http::response([
+            'accounts' => [['name' => 'accounts/111']],
+        ], 200),
+        config('trypost.platforms.google_business.business_information_api').'/accounts/111/locations*' => Http::response([
+            'locations' => [
+                ['name' => 'accounts/111/locations/222', 'title' => 'Downtown Store', 'storefrontAddress' => ['addressLines' => ['123 Main St'], 'locality' => 'Springfield']],
+            ],
+        ], 200),
+    ]);
+
+    $locations = $this->publisher->fetchLocations('fake-access-token');
+
+    expect($locations)->toHaveCount(1);
+    expect($locations[0])->toMatchArray([
+        'id' => 'accounts/111/locations/222',
+        'account_name' => 'accounts/111',
+        'location_name' => 'accounts/111/locations/222',
+        'title' => 'Downtown Store',
+        'address' => '123 Main St, Springfield',
+    ]);
+
+    Http::assertSent(function ($request) {
+        parse_str((string) parse_url($request->url(), PHP_URL_QUERY), $query);
+
+        return $request->method() === 'GET'
+            && str_starts_with($request->url(), config('trypost.platforms.google_business.account_management_api').'/accounts')
+            && data_get($query, 'pageSize') === '100';
+    });
+
+    Http::assertSent(function ($request) {
+        parse_str((string) parse_url($request->url(), PHP_URL_QUERY), $query);
+
+        return $request->method() === 'GET'
+            && str_starts_with($request->url(), config('trypost.platforms.google_business.business_information_api').'/accounts/111/locations')
+            && data_get($query, 'readMask') === 'name,title,storefrontAddress,metadata';
+    });
+});

From cf0423ffcdc2dc18dbb8849ef466e30d886c81b0 Mon Sep 17 00:00:00 2001
From: Paulo Castellano <paulo@castellanos.llc>
Date: Mon, 10 Aug 2026 23:25:22 -0300
Subject: [PATCH 07/47] feat: add GoogleBusinessAnalytics location performance
 metrics

Implements GoogleBusinessAnalytics service to fetch five Google Business
Profile performance metrics (website clicks, call clicks, direction
requests, desktop map impressions, mobile map impressions) via the
Performance API. Adds i18n keys to all 16 locale files.

TDD: Red test passing, 3 assertions validated.
---
 .../Social/GoogleBusinessAnalytics.php        | 88 +++++++++++++++++++
 lang/ar/analytics.php                         |  5 ++
 lang/de/analytics.php                         |  5 ++
 lang/el/analytics.php                         |  5 ++
 lang/en/analytics.php                         |  5 ++
 lang/es/analytics.php                         |  5 ++
 lang/fr/analytics.php                         |  5 ++
 lang/it/analytics.php                         |  5 ++
 lang/ja/analytics.php                         |  5 ++
 lang/ko/analytics.php                         |  5 ++
 lang/nl/analytics.php                         |  5 ++
 lang/pl/analytics.php                         |  5 ++
 lang/pt-BR/analytics.php                      |  5 ++
 lang/ru/analytics.php                         |  5 ++
 lang/tr/analytics.php                         |  5 ++
 lang/uk/analytics.php                         |  5 ++
 lang/zh/analytics.php                         |  5 ++
 .../Social/GoogleBusinessAnalyticsTest.php    | 56 ++++++++++++
 18 files changed, 224 insertions(+)
 create mode 100644 app/Services/Social/GoogleBusinessAnalytics.php
 create mode 100644 tests/Feature/Services/Social/GoogleBusinessAnalyticsTest.php

diff --git a/app/Services/Social/GoogleBusinessAnalytics.php b/app/Services/Social/GoogleBusinessAnalytics.php
new file mode 100644
index 000000000..e46c7abb7
--- /dev/null
+++ b/app/Services/Social/GoogleBusinessAnalytics.php
@@ -0,0 +1,88 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Services\Social;
+
+use App\Models\SocialAccount;
+use App\Services\Social\Concerns\HasSocialHttpClient;
+use Carbon\CarbonInterface;
+use Illuminate\Support\Facades\Log;
+
+class GoogleBusinessAnalytics
+{
+    use HasSocialHttpClient;
+
+    /** @var array<string, string> Google metric enum => translation key. */
+    private const METRICS = [
+        'WEBSITE_CLICKS' => 'analytics.metrics.website_clicks',
+        'CALL_CLICKS' => 'analytics.metrics.call_clicks',
+        'BUSINESS_DIRECTION_REQUESTS' => 'analytics.metrics.direction_requests',
+        'BUSINESS_IMPRESSIONS_DESKTOP_MAPS' => 'analytics.metrics.desktop_map_impressions',
+        'BUSINESS_IMPRESSIONS_MOBILE_MAPS' => 'analytics.metrics.mobile_map_impressions',
+    ];
+
+    private string $baseUrl;
+
+    public function __construct()
+    {
+        $this->baseUrl = config('trypost.platforms.google_business.performance_api');
+    }
+
+    public function getMetrics(SocialAccount $account, ?CarbonInterface $since = null, ?CarbonInterface $until = null): array
+    {
+        $since ??= now()->subDays(7);
+        $until ??= now();
+
+        if ($account->needsProactiveTokenRefresh()) {
+            app(ConnectionVerifier::class)->refreshToken($account);
+        }
+
+        $locationId = (string) data_get($account->meta, 'location_id');
+
+        if (blank($locationId)) {
+            return [];
+        }
+
+        $response = $this->socialHttp()->withToken($account->access_token)
+            ->get("{$this->baseUrl}/{$locationId}:fetchMultiDailyMetricsTimeSeries", [
+                'dailyMetrics' => array_keys(self::METRICS),
+                'dailyRange.start_date.year' => $since->format('Y'),
+                'dailyRange.start_date.month' => $since->format('n'),
+                'dailyRange.start_date.day' => $since->format('j'),
+                'dailyRange.end_date.year' => $until->format('Y'),
+                'dailyRange.end_date.month' => $until->format('n'),
+                'dailyRange.end_date.day' => $until->format('j'),
+            ]);
+
+        if ($response->failed()) {
+            Log::warning('Google Business Profile analytics fetch failed', [
+                'body' => $this->redactResponseBody($response->body()),
+            ]);
+
+            return [];
+        }
+
+        $series = data_get($response->json(), 'multiDailyMetricTimeSeries.0.dailyMetricTimeSeries', []);
+
+        $totals = collect(self::METRICS)->mapWithKeys(fn ($labelKey, $metric) => [$metric => 0])->all();
+
+        foreach ($series as $entry) {
+            $metric = data_get($entry, 'dailyMetric');
+
+            if (! array_key_exists($metric, $totals)) {
+                continue;
+            }
+
+            $values = collect(data_get($entry, 'timeSeries.datedValues', []))
+                ->sum(fn ($value) => (int) data_get($value, 'value', 0));
+
+            $totals[$metric] = $values;
+        }
+
+        return collect(self::METRICS)
+            ->map(fn (string $labelKey, string $metric) => ['label' => __($labelKey), 'value' => $totals[$metric]])
+            ->values()
+            ->all();
+    }
+}
diff --git a/lang/ar/analytics.php b/lang/ar/analytics.php
index 025526c5f..a84ea400f 100644
--- a/lang/ar/analytics.php
+++ b/lang/ar/analytics.php
@@ -51,5 +51,10 @@
         'video_views' => 'مشاهدات الفيديو',
         'videos' => 'مقاطع الفيديو',
         'views' => 'المشاهدات',
+        'website_clicks' => 'Website clicks',
+        'call_clicks' => 'Call clicks',
+        'direction_requests' => 'Direction requests',
+        'desktop_map_impressions' => 'Desktop map impressions',
+        'mobile_map_impressions' => 'Mobile map impressions',
     ],
 ];
diff --git a/lang/de/analytics.php b/lang/de/analytics.php
index 57e97d26f..a6e74698a 100644
--- a/lang/de/analytics.php
+++ b/lang/de/analytics.php
@@ -53,5 +53,10 @@
         'video_views' => 'Videoaufrufe',
         'videos' => 'Videos',
         'views' => 'Aufrufe',
+        'website_clicks' => 'Website clicks',
+        'call_clicks' => 'Call clicks',
+        'direction_requests' => 'Direction requests',
+        'desktop_map_impressions' => 'Desktop map impressions',
+        'mobile_map_impressions' => 'Mobile map impressions',
     ],
 ];
diff --git a/lang/el/analytics.php b/lang/el/analytics.php
index 779ecc226..05bca1ef8 100644
--- a/lang/el/analytics.php
+++ b/lang/el/analytics.php
@@ -51,5 +51,10 @@
         'video_views' => 'Προβολές βίντεο',
         'videos' => 'Βίντεο',
         'views' => 'Προβολές',
+        'website_clicks' => 'Website clicks',
+        'call_clicks' => 'Call clicks',
+        'direction_requests' => 'Direction requests',
+        'desktop_map_impressions' => 'Desktop map impressions',
+        'mobile_map_impressions' => 'Mobile map impressions',
     ],
 ];
diff --git a/lang/en/analytics.php b/lang/en/analytics.php
index 99c8190c2..49f8929d1 100644
--- a/lang/en/analytics.php
+++ b/lang/en/analytics.php
@@ -51,5 +51,10 @@
         'video_views' => 'Video Views',
         'videos' => 'Videos',
         'views' => 'Views',
+        'website_clicks' => 'Website clicks',
+        'call_clicks' => 'Call clicks',
+        'direction_requests' => 'Direction requests',
+        'desktop_map_impressions' => 'Desktop map impressions',
+        'mobile_map_impressions' => 'Mobile map impressions',
     ],
 ];
diff --git a/lang/es/analytics.php b/lang/es/analytics.php
index da4d2a406..dba9c49b8 100644
--- a/lang/es/analytics.php
+++ b/lang/es/analytics.php
@@ -51,5 +51,10 @@
         'video_views' => 'Vistas de Vídeo',
         'videos' => 'Vídeos',
         'views' => 'Vistas',
+        'website_clicks' => 'Website clicks',
+        'call_clicks' => 'Call clicks',
+        'direction_requests' => 'Direction requests',
+        'desktop_map_impressions' => 'Desktop map impressions',
+        'mobile_map_impressions' => 'Mobile map impressions',
     ],
 ];
diff --git a/lang/fr/analytics.php b/lang/fr/analytics.php
index c26d20b15..e664ec5e5 100644
--- a/lang/fr/analytics.php
+++ b/lang/fr/analytics.php
@@ -51,5 +51,10 @@
         'video_views' => 'Vues de la vidéo',
         'videos' => 'Vidéos',
         'views' => 'Vues',
+        'website_clicks' => 'Website clicks',
+        'call_clicks' => 'Call clicks',
+        'direction_requests' => 'Direction requests',
+        'desktop_map_impressions' => 'Desktop map impressions',
+        'mobile_map_impressions' => 'Mobile map impressions',
     ],
 ];
diff --git a/lang/it/analytics.php b/lang/it/analytics.php
index 2bce4a934..322694155 100644
--- a/lang/it/analytics.php
+++ b/lang/it/analytics.php
@@ -51,5 +51,10 @@
         'video_views' => 'Visualizzazioni video',
         'videos' => 'Video',
         'views' => 'Visualizzazioni',
+        'website_clicks' => 'Website clicks',
+        'call_clicks' => 'Call clicks',
+        'direction_requests' => 'Direction requests',
+        'desktop_map_impressions' => 'Desktop map impressions',
+        'mobile_map_impressions' => 'Mobile map impressions',
     ],
 ];
diff --git a/lang/ja/analytics.php b/lang/ja/analytics.php
index 22f015157..80e51760c 100644
--- a/lang/ja/analytics.php
+++ b/lang/ja/analytics.php
@@ -51,5 +51,10 @@
         'video_views' => '動画再生数',
         'videos' => '動画',
         'views' => '再生数',
+        'website_clicks' => 'Website clicks',
+        'call_clicks' => 'Call clicks',
+        'direction_requests' => 'Direction requests',
+        'desktop_map_impressions' => 'Desktop map impressions',
+        'mobile_map_impressions' => 'Mobile map impressions',
     ],
 ];
diff --git a/lang/ko/analytics.php b/lang/ko/analytics.php
index 946ba066c..895ecc8aa 100644
--- a/lang/ko/analytics.php
+++ b/lang/ko/analytics.php
@@ -51,5 +51,10 @@
         'video_views' => '동영상 조회수',
         'videos' => '동영상',
         'views' => '조회수',
+        'website_clicks' => 'Website clicks',
+        'call_clicks' => 'Call clicks',
+        'direction_requests' => 'Direction requests',
+        'desktop_map_impressions' => 'Desktop map impressions',
+        'mobile_map_impressions' => 'Mobile map impressions',
     ],
 ];
diff --git a/lang/nl/analytics.php b/lang/nl/analytics.php
index e62378ec1..ba7f8aa33 100644
--- a/lang/nl/analytics.php
+++ b/lang/nl/analytics.php
@@ -51,5 +51,10 @@
         'video_views' => 'Videoweergaven',
         'videos' => 'Video\'s',
         'views' => 'Weergaven',
+        'website_clicks' => 'Website clicks',
+        'call_clicks' => 'Call clicks',
+        'direction_requests' => 'Direction requests',
+        'desktop_map_impressions' => 'Desktop map impressions',
+        'mobile_map_impressions' => 'Mobile map impressions',
     ],
 ];
diff --git a/lang/pl/analytics.php b/lang/pl/analytics.php
index 19def1bd9..632257489 100644
--- a/lang/pl/analytics.php
+++ b/lang/pl/analytics.php
@@ -51,5 +51,10 @@
         'video_views' => 'Wyświetlenia wideo',
         'videos' => 'Filmy',
         'views' => 'Wyświetlenia',
+        'website_clicks' => 'Website clicks',
+        'call_clicks' => 'Call clicks',
+        'direction_requests' => 'Direction requests',
+        'desktop_map_impressions' => 'Desktop map impressions',
+        'mobile_map_impressions' => 'Mobile map impressions',
     ],
 ];
diff --git a/lang/pt-BR/analytics.php b/lang/pt-BR/analytics.php
index bad4c550d..c33fcecc6 100644
--- a/lang/pt-BR/analytics.php
+++ b/lang/pt-BR/analytics.php
@@ -51,5 +51,10 @@
         'video_views' => 'Visualizações de Vídeo',
         'videos' => 'Vídeos',
         'views' => 'Visualizações',
+        'website_clicks' => 'Website clicks',
+        'call_clicks' => 'Call clicks',
+        'direction_requests' => 'Direction requests',
+        'desktop_map_impressions' => 'Desktop map impressions',
+        'mobile_map_impressions' => 'Mobile map impressions',
     ],
 ];
diff --git a/lang/ru/analytics.php b/lang/ru/analytics.php
index a0c767540..144b36457 100644
--- a/lang/ru/analytics.php
+++ b/lang/ru/analytics.php
@@ -51,5 +51,10 @@
         'video_views' => 'Просмотры видео',
         'videos' => 'Видео',
         'views' => 'Просмотры',
+        'website_clicks' => 'Website clicks',
+        'call_clicks' => 'Call clicks',
+        'direction_requests' => 'Direction requests',
+        'desktop_map_impressions' => 'Desktop map impressions',
+        'mobile_map_impressions' => 'Mobile map impressions',
     ],
 ];
diff --git a/lang/tr/analytics.php b/lang/tr/analytics.php
index daafd3b3b..d4b74244c 100644
--- a/lang/tr/analytics.php
+++ b/lang/tr/analytics.php
@@ -53,5 +53,10 @@
         'video_views' => 'Video Görüntülemeleri',
         'videos' => 'Videolar',
         'views' => 'Görüntülemeler',
+        'website_clicks' => 'Website clicks',
+        'call_clicks' => 'Call clicks',
+        'direction_requests' => 'Direction requests',
+        'desktop_map_impressions' => 'Desktop map impressions',
+        'mobile_map_impressions' => 'Mobile map impressions',
     ],
 ];
diff --git a/lang/uk/analytics.php b/lang/uk/analytics.php
index 1a4891b22..5fb3a810b 100644
--- a/lang/uk/analytics.php
+++ b/lang/uk/analytics.php
@@ -51,5 +51,10 @@
         'video_views' => 'Перегляди відео',
         'videos' => 'Відео',
         'views' => 'Перегляди',
+        'website_clicks' => 'Website clicks',
+        'call_clicks' => 'Call clicks',
+        'direction_requests' => 'Direction requests',
+        'desktop_map_impressions' => 'Desktop map impressions',
+        'mobile_map_impressions' => 'Mobile map impressions',
     ],
 ];
diff --git a/lang/zh/analytics.php b/lang/zh/analytics.php
index d9e81278d..1a5f29b1e 100644
--- a/lang/zh/analytics.php
+++ b/lang/zh/analytics.php
@@ -51,5 +51,10 @@
         'video_views' => '视频观看量',
         'videos' => '视频',
         'views' => '观看量',
+        'website_clicks' => 'Website clicks',
+        'call_clicks' => 'Call clicks',
+        'direction_requests' => 'Direction requests',
+        'desktop_map_impressions' => 'Desktop map impressions',
+        'mobile_map_impressions' => 'Mobile map impressions',
     ],
 ];
diff --git a/tests/Feature/Services/Social/GoogleBusinessAnalyticsTest.php b/tests/Feature/Services/Social/GoogleBusinessAnalyticsTest.php
new file mode 100644
index 000000000..a5d086234
--- /dev/null
+++ b/tests/Feature/Services/Social/GoogleBusinessAnalyticsTest.php
@@ -0,0 +1,56 @@
+<?php
+
+declare(strict_types=1);
+
+use App\Models\SocialAccount;
+use App\Models\User;
+use App\Models\Workspace;
+use App\Services\Social\GoogleBusinessAnalytics;
+use Illuminate\Support\Facades\Http;
+
+beforeEach(function () {
+    $this->user = User::factory()->create();
+    $this->workspace = Workspace::factory()->create(['user_id' => $this->user->id]);
+    $this->socialAccount = SocialAccount::factory()->googleBusiness()->create([
+        'workspace_id' => $this->workspace->id,
+        'token_expires_at' => now()->addHour(),
+    ]);
+    $this->analytics = new GoogleBusinessAnalytics;
+});
+
+test('fetches the five performance metrics for the account location', function () {
+    Http::fake([
+        config('trypost.platforms.google_business.performance_api').'/*' => Http::response([
+            'multiDailyMetricTimeSeries' => [
+                [
+                    'dailyMetricTimeSeries' => [
+                        [
+                            'dailyMetric' => 'WEBSITE_CLICKS',
+                            'timeSeries' => ['datedValues' => [['value' => '10'], ['value' => '5']]],
+                        ],
+                        [
+                            'dailyMetric' => 'CALL_CLICKS',
+                            'timeSeries' => ['datedValues' => [['value' => '3']]],
+                        ],
+                    ],
+                ],
+            ],
+        ], 200),
+    ]);
+
+    $metrics = $this->analytics->getMetrics($this->socialAccount);
+
+    $labels = array_column($metrics, 'label');
+    expect($labels)->toHaveCount(5);
+
+    $websiteClicks = collect($metrics)->firstWhere('label', __('analytics.metrics.website_clicks'));
+    expect($websiteClicks['value'])->toBe(15);
+});
+
+test('returns empty array on api failure', function () {
+    Http::fake([
+        config('trypost.platforms.google_business.performance_api').'/*' => Http::response([], 500),
+    ]);
+
+    expect($this->analytics->getMetrics($this->socialAccount))->toBe([]);
+});

From 25c7279008e9751c8665ba36465f762d2ef750ca Mon Sep 17 00:00:00 2001
From: Paulo Castellano <paulo@castellanos.llc>
Date: Mon, 10 Aug 2026 23:30:35 -0300
Subject: [PATCH 08/47] fix: translate Google Business Profile metrics keys to
 all locales

Replace English translations in 15 non-English locale files with proper
translations matching each locale's existing terminology and style:
- Arabic: Arabic translations
- German: German translations
- Greek: Greek translations
- Spanish: Spanish translations
- French: French translations
- Italian: Italian translations
- Japanese: Japanese translations
- Korean: Korean translations
- Dutch: Dutch translations
- Polish: Polish translations
- Portuguese-BR: Portuguese translations
- Russian: Russian translations
- Turkish: Turkish translations
- Ukrainian: Ukrainian translations
- Chinese: Chinese (Simplified) translations

Verified by: LocalizationParityTest (18 passed) + GoogleBusinessAnalytics (2 passed)
---
 lang/ar/analytics.php    | 10 +++++-----
 lang/de/analytics.php    | 10 +++++-----
 lang/el/analytics.php    | 10 +++++-----
 lang/es/analytics.php    | 10 +++++-----
 lang/fr/analytics.php    | 10 +++++-----
 lang/it/analytics.php    | 10 +++++-----
 lang/ja/analytics.php    | 10 +++++-----
 lang/ko/analytics.php    | 10 +++++-----
 lang/nl/analytics.php    | 10 +++++-----
 lang/pl/analytics.php    | 10 +++++-----
 lang/pt-BR/analytics.php | 10 +++++-----
 lang/ru/analytics.php    | 10 +++++-----
 lang/tr/analytics.php    | 10 +++++-----
 lang/uk/analytics.php    | 10 +++++-----
 lang/zh/analytics.php    | 10 +++++-----
 15 files changed, 75 insertions(+), 75 deletions(-)

diff --git a/lang/ar/analytics.php b/lang/ar/analytics.php
index a84ea400f..ade67406c 100644
--- a/lang/ar/analytics.php
+++ b/lang/ar/analytics.php
@@ -51,10 +51,10 @@
         'video_views' => 'مشاهدات الفيديو',
         'videos' => 'مقاطع الفيديو',
         'views' => 'المشاهدات',
-        'website_clicks' => 'Website clicks',
-        'call_clicks' => 'Call clicks',
-        'direction_requests' => 'Direction requests',
-        'desktop_map_impressions' => 'Desktop map impressions',
-        'mobile_map_impressions' => 'Mobile map impressions',
+        'website_clicks' => 'نقرات الموقع الإلكتروني',
+        'call_clicks' => 'نقرات الاتصال',
+        'direction_requests' => 'طلبات الاتجاهات',
+        'desktop_map_impressions' => 'مرات ظهور الخريطة على سطح المكتب',
+        'mobile_map_impressions' => 'مرات ظهور الخريطة على الجوال',
     ],
 ];
diff --git a/lang/de/analytics.php b/lang/de/analytics.php
index a6e74698a..c79c8e57b 100644
--- a/lang/de/analytics.php
+++ b/lang/de/analytics.php
@@ -53,10 +53,10 @@
         'video_views' => 'Videoaufrufe',
         'videos' => 'Videos',
         'views' => 'Aufrufe',
-        'website_clicks' => 'Website clicks',
-        'call_clicks' => 'Call clicks',
-        'direction_requests' => 'Direction requests',
-        'desktop_map_impressions' => 'Desktop map impressions',
-        'mobile_map_impressions' => 'Mobile map impressions',
+        'website_clicks' => 'Website-Klicks',
+        'call_clicks' => 'Anruf-Klicks',
+        'direction_requests' => 'Routenanfragen',
+        'desktop_map_impressions' => 'Kartenimpressionen auf dem Desktop',
+        'mobile_map_impressions' => 'Kartenimpressionen auf Mobilgeräten',
     ],
 ];
diff --git a/lang/el/analytics.php b/lang/el/analytics.php
index 05bca1ef8..70e42093a 100644
--- a/lang/el/analytics.php
+++ b/lang/el/analytics.php
@@ -51,10 +51,10 @@
         'video_views' => 'Προβολές βίντεο',
         'videos' => 'Βίντεο',
         'views' => 'Προβολές',
-        'website_clicks' => 'Website clicks',
-        'call_clicks' => 'Call clicks',
-        'direction_requests' => 'Direction requests',
-        'desktop_map_impressions' => 'Desktop map impressions',
-        'mobile_map_impressions' => 'Mobile map impressions',
+        'website_clicks' => 'Κλικ ιστοσελίδας',
+        'call_clicks' => 'Κλικ κλήσης',
+        'direction_requests' => 'Αιτήματα κατεύθυνσης',
+        'desktop_map_impressions' => 'Εμφανίσεις χάρτη σε υπολογιστή',
+        'mobile_map_impressions' => 'Εμφανίσεις χάρτη σε κινητό',
     ],
 ];
diff --git a/lang/es/analytics.php b/lang/es/analytics.php
index dba9c49b8..e1c887418 100644
--- a/lang/es/analytics.php
+++ b/lang/es/analytics.php
@@ -51,10 +51,10 @@
         'video_views' => 'Vistas de Vídeo',
         'videos' => 'Vídeos',
         'views' => 'Vistas',
-        'website_clicks' => 'Website clicks',
-        'call_clicks' => 'Call clicks',
-        'direction_requests' => 'Direction requests',
-        'desktop_map_impressions' => 'Desktop map impressions',
-        'mobile_map_impressions' => 'Mobile map impressions',
+        'website_clicks' => 'Clics de Sitio Web',
+        'call_clicks' => 'Clics de Llamada',
+        'direction_requests' => 'Solicitudes de Dirección',
+        'desktop_map_impressions' => 'Impresiones de Mapa de Escritorio',
+        'mobile_map_impressions' => 'Impresiones de Mapa Móvil',
     ],
 ];
diff --git a/lang/fr/analytics.php b/lang/fr/analytics.php
index e664ec5e5..1eaa169e0 100644
--- a/lang/fr/analytics.php
+++ b/lang/fr/analytics.php
@@ -51,10 +51,10 @@
         'video_views' => 'Vues de la vidéo',
         'videos' => 'Vidéos',
         'views' => 'Vues',
-        'website_clicks' => 'Website clicks',
-        'call_clicks' => 'Call clicks',
-        'direction_requests' => 'Direction requests',
-        'desktop_map_impressions' => 'Desktop map impressions',
-        'mobile_map_impressions' => 'Mobile map impressions',
+        'website_clicks' => 'Clics sur le site web',
+        'call_clicks' => 'Clics d\'appel',
+        'direction_requests' => 'Demandes d\'itinéraire',
+        'desktop_map_impressions' => 'Impressions de carte sur ordinateur',
+        'mobile_map_impressions' => 'Impressions de carte sur mobile',
     ],
 ];
diff --git a/lang/it/analytics.php b/lang/it/analytics.php
index 322694155..5333d62af 100644
--- a/lang/it/analytics.php
+++ b/lang/it/analytics.php
@@ -51,10 +51,10 @@
         'video_views' => 'Visualizzazioni video',
         'videos' => 'Video',
         'views' => 'Visualizzazioni',
-        'website_clicks' => 'Website clicks',
-        'call_clicks' => 'Call clicks',
-        'direction_requests' => 'Direction requests',
-        'desktop_map_impressions' => 'Desktop map impressions',
-        'mobile_map_impressions' => 'Mobile map impressions',
+        'website_clicks' => 'Clic sul sito web',
+        'call_clicks' => 'Clic sulla chiamata',
+        'direction_requests' => 'Richieste di indicazioni',
+        'desktop_map_impressions' => 'Impressioni della mappa su desktop',
+        'mobile_map_impressions' => 'Impressioni della mappa mobile',
     ],
 ];
diff --git a/lang/ja/analytics.php b/lang/ja/analytics.php
index 80e51760c..ca4837853 100644
--- a/lang/ja/analytics.php
+++ b/lang/ja/analytics.php
@@ -51,10 +51,10 @@
         'video_views' => '動画再生数',
         'videos' => '動画',
         'views' => '再生数',
-        'website_clicks' => 'Website clicks',
-        'call_clicks' => 'Call clicks',
-        'direction_requests' => 'Direction requests',
-        'desktop_map_impressions' => 'Desktop map impressions',
-        'mobile_map_impressions' => 'Mobile map impressions',
+        'website_clicks' => 'ウェブサイトクリック',
+        'call_clicks' => '通話クリック',
+        'direction_requests' => '経路リクエスト',
+        'desktop_map_impressions' => 'デスクトップ地図インプレッション',
+        'mobile_map_impressions' => 'モバイル地図インプレッション',
     ],
 ];
diff --git a/lang/ko/analytics.php b/lang/ko/analytics.php
index 895ecc8aa..fbe72aa2d 100644
--- a/lang/ko/analytics.php
+++ b/lang/ko/analytics.php
@@ -51,10 +51,10 @@
         'video_views' => '동영상 조회수',
         'videos' => '동영상',
         'views' => '조회수',
-        'website_clicks' => 'Website clicks',
-        'call_clicks' => 'Call clicks',
-        'direction_requests' => 'Direction requests',
-        'desktop_map_impressions' => 'Desktop map impressions',
-        'mobile_map_impressions' => 'Mobile map impressions',
+        'website_clicks' => '웹사이트 클릭',
+        'call_clicks' => '통화 클릭',
+        'direction_requests' => '길찾기 요청',
+        'desktop_map_impressions' => '데스크톱 지도 노출수',
+        'mobile_map_impressions' => '모바일 지도 노출수',
     ],
 ];
diff --git a/lang/nl/analytics.php b/lang/nl/analytics.php
index ba7f8aa33..5225b21d6 100644
--- a/lang/nl/analytics.php
+++ b/lang/nl/analytics.php
@@ -51,10 +51,10 @@
         'video_views' => 'Videoweergaven',
         'videos' => 'Video\'s',
         'views' => 'Weergaven',
-        'website_clicks' => 'Website clicks',
-        'call_clicks' => 'Call clicks',
-        'direction_requests' => 'Direction requests',
-        'desktop_map_impressions' => 'Desktop map impressions',
-        'mobile_map_impressions' => 'Mobile map impressions',
+        'website_clicks' => 'Websiteklikken',
+        'call_clicks' => 'Oproepklikken',
+        'direction_requests' => 'Routeaanvragen',
+        'desktop_map_impressions' => 'Kaartweergaven op desktop',
+        'mobile_map_impressions' => 'Kaartweergaven op mobiel',
     ],
 ];
diff --git a/lang/pl/analytics.php b/lang/pl/analytics.php
index 632257489..872c516d2 100644
--- a/lang/pl/analytics.php
+++ b/lang/pl/analytics.php
@@ -51,10 +51,10 @@
         'video_views' => 'Wyświetlenia wideo',
         'videos' => 'Filmy',
         'views' => 'Wyświetlenia',
-        'website_clicks' => 'Website clicks',
-        'call_clicks' => 'Call clicks',
-        'direction_requests' => 'Direction requests',
-        'desktop_map_impressions' => 'Desktop map impressions',
-        'mobile_map_impressions' => 'Mobile map impressions',
+        'website_clicks' => 'Kliknięcia witryny',
+        'call_clicks' => 'Kliknięcia połączeń',
+        'direction_requests' => 'Żądania tras',
+        'desktop_map_impressions' => 'Wyświetlenia map na komputerze',
+        'mobile_map_impressions' => 'Wyświetlenia map na urządzeniu mobilnym',
     ],
 ];
diff --git a/lang/pt-BR/analytics.php b/lang/pt-BR/analytics.php
index c33fcecc6..c3a3e05d2 100644
--- a/lang/pt-BR/analytics.php
+++ b/lang/pt-BR/analytics.php
@@ -51,10 +51,10 @@
         'video_views' => 'Visualizações de Vídeo',
         'videos' => 'Vídeos',
         'views' => 'Visualizações',
-        'website_clicks' => 'Website clicks',
-        'call_clicks' => 'Call clicks',
-        'direction_requests' => 'Direction requests',
-        'desktop_map_impressions' => 'Desktop map impressions',
-        'mobile_map_impressions' => 'Mobile map impressions',
+        'website_clicks' => 'Cliques no Site',
+        'call_clicks' => 'Cliques de Chamada',
+        'direction_requests' => 'Solicitações de Direções',
+        'desktop_map_impressions' => 'Impressões de Mapa no Desktop',
+        'mobile_map_impressions' => 'Impressões de Mapa no Celular',
     ],
 ];
diff --git a/lang/ru/analytics.php b/lang/ru/analytics.php
index 144b36457..08b4b4707 100644
--- a/lang/ru/analytics.php
+++ b/lang/ru/analytics.php
@@ -51,10 +51,10 @@
         'video_views' => 'Просмотры видео',
         'videos' => 'Видео',
         'views' => 'Просмотры',
-        'website_clicks' => 'Website clicks',
-        'call_clicks' => 'Call clicks',
-        'direction_requests' => 'Direction requests',
-        'desktop_map_impressions' => 'Desktop map impressions',
-        'mobile_map_impressions' => 'Mobile map impressions',
+        'website_clicks' => 'Клики по веб-сайту',
+        'call_clicks' => 'Клики на звонок',
+        'direction_requests' => 'Запросы маршрутов',
+        'desktop_map_impressions' => 'Показы карты на ПК',
+        'mobile_map_impressions' => 'Показы карты на мобильном',
     ],
 ];
diff --git a/lang/tr/analytics.php b/lang/tr/analytics.php
index d4b74244c..7eb3d76ec 100644
--- a/lang/tr/analytics.php
+++ b/lang/tr/analytics.php
@@ -53,10 +53,10 @@
         'video_views' => 'Video Görüntülemeleri',
         'videos' => 'Videolar',
         'views' => 'Görüntülemeler',
-        'website_clicks' => 'Website clicks',
-        'call_clicks' => 'Call clicks',
-        'direction_requests' => 'Direction requests',
-        'desktop_map_impressions' => 'Desktop map impressions',
-        'mobile_map_impressions' => 'Mobile map impressions',
+        'website_clicks' => 'Web Sitesi Tıklamaları',
+        'call_clicks' => 'Arama Tıklamaları',
+        'direction_requests' => 'Rota Talepleri',
+        'desktop_map_impressions' => 'Masaüstü Harita Gösterimleri',
+        'mobile_map_impressions' => 'Mobil Harita Gösterimleri',
     ],
 ];
diff --git a/lang/uk/analytics.php b/lang/uk/analytics.php
index 5fb3a810b..ef35d95b0 100644
--- a/lang/uk/analytics.php
+++ b/lang/uk/analytics.php
@@ -51,10 +51,10 @@
         'video_views' => 'Перегляди відео',
         'videos' => 'Відео',
         'views' => 'Перегляди',
-        'website_clicks' => 'Website clicks',
-        'call_clicks' => 'Call clicks',
-        'direction_requests' => 'Direction requests',
-        'desktop_map_impressions' => 'Desktop map impressions',
-        'mobile_map_impressions' => 'Mobile map impressions',
+        'website_clicks' => 'Кліки по веб-сайту',
+        'call_clicks' => 'Кліки на дзвінок',
+        'direction_requests' => 'Запити маршрутів',
+        'desktop_map_impressions' => 'Покази карти на комп\'ютері',
+        'mobile_map_impressions' => 'Покази карти на мобільному',
     ],
 ];
diff --git a/lang/zh/analytics.php b/lang/zh/analytics.php
index 1a5f29b1e..8a150b21f 100644
--- a/lang/zh/analytics.php
+++ b/lang/zh/analytics.php
@@ -51,10 +51,10 @@
         'video_views' => '视频观看量',
         'videos' => '视频',
         'views' => '观看量',
-        'website_clicks' => 'Website clicks',
-        'call_clicks' => 'Call clicks',
-        'direction_requests' => 'Direction requests',
-        'desktop_map_impressions' => 'Desktop map impressions',
-        'mobile_map_impressions' => 'Mobile map impressions',
+        'website_clicks' => '网站点击',
+        'call_clicks' => '通话点击',
+        'direction_requests' => '方向请求',
+        'desktop_map_impressions' => '桌面地图展示量',
+        'mobile_map_impressions' => '移动地图展示量',
     ],
 ];

From 0336dffe5964e5e99b2637dc54eb31b5288686fa Mon Sep 17 00:00:00 2001
From: Paulo Castellano <paulo@castellanos.llc>
Date: Mon, 10 Aug 2026 23:34:21 -0300
Subject: [PATCH 09/47] feat: verify and refresh Google Business Profile tokens

---
 app/Services/Social/ConnectionVerifier.php    | 50 +++++++++++++++++++
 .../Social/ConnectionVerifierTest.php         | 38 ++++++++++++++
 2 files changed, 88 insertions(+)

diff --git a/app/Services/Social/ConnectionVerifier.php b/app/Services/Social/ConnectionVerifier.php
index 954e83298..54d3d0da7 100644
--- a/app/Services/Social/ConnectionVerifier.php
+++ b/app/Services/Social/ConnectionVerifier.php
@@ -8,6 +8,7 @@
 use App\Exceptions\PlatformUnavailableException;
 use App\Exceptions\Social\BlueskyPublishException;
 use App\Exceptions\Social\DiscordPublishException;
+use App\Exceptions\Social\GoogleBusinessPublishException;
 use App\Exceptions\Social\LinkedInPublishException;
 use App\Exceptions\Social\MastodonPublishException;
 use App\Exceptions\Social\PinterestPublishException;
@@ -115,6 +116,7 @@ private function callVerifyEndpoint(SocialAccount $account): bool
             Platform::Mastodon => $this->verifyMastodon($account),
             Platform::Telegram => $this->verifyTelegram($account),
             Platform::Discord => $this->verifyDiscord($account),
+            Platform::GoogleBusiness => $this->verifyGoogleBusiness($account),
         };
     }
 
@@ -148,6 +150,7 @@ public function refreshToken(SocialAccount $account): void
                 Platform::Pinterest => $this->refreshPinterestToken($account),
                 Platform::Threads => $this->refreshThreadsToken($account),
                 Platform::Instagram => $this->refreshInstagramToken($account),
+                Platform::GoogleBusiness => $this->refreshGoogleBusinessToken($account),
                 // Facebook / InstagramFacebook use Page tokens that don't expire.
                 // Mastodon tokens don't expire either.
                 default => null,
@@ -375,6 +378,30 @@ private function refreshInstagramToken(SocialAccount $account): void
         $account->refresh();
     }
 
+    private function refreshGoogleBusinessToken(SocialAccount $account): void
+    {
+        if (! $account->refresh_token) {
+            throw new TokenExpiredException('No refresh token available for Google Business Profile account');
+        }
+
+        $response = TokenRefreshClient::for(Platform::GoogleBusiness)->send(fn () => Http::asForm()
+            ->post(config('trypost.platforms.google_business.oauth_api').'/token', [
+                'grant_type' => 'refresh_token',
+                'refresh_token' => $account->refresh_token,
+                'client_id' => config('services.google-business.client_id'),
+                'client_secret' => config('services.google-business.client_secret'),
+            ]));
+
+        $data = $response->json();
+
+        $account->update([
+            'access_token' => data_get($data, 'access_token'),
+            'token_expires_at' => data_get($data, 'expires_in') ? now()->addSeconds(data_get($data, 'expires_in')) : null,
+        ]);
+
+        $account->refresh();
+    }
+
     private function verifyLinkedIn(SocialAccount $account): bool
     {
         $response = Http::withToken($account->access_token)
@@ -641,4 +668,27 @@ private function verifyMastodon(SocialAccount $account): bool
             $response->status(),
         );
     }
+
+    private function verifyGoogleBusiness(SocialAccount $account): bool
+    {
+        $locationId = data_get($account->meta, 'location_id');
+
+        $response = Http::withToken($account->access_token)
+            ->get(config('trypost.platforms.google_business.business_information_api')."/{$locationId}", [
+                'readMask' => 'name',
+            ]);
+
+        if (GoogleBusinessPublishException::isConfirmedDeadToken($response)) {
+            throw new TokenExpiredException('Google Business Profile access token is invalid or expired');
+        }
+
+        if ($response->successful()) {
+            return true;
+        }
+
+        throw new PlatformUnavailableException(
+            "{$account->platform->label()} verify failed ({$response->status()}).",
+            $response->status(),
+        );
+    }
 }
diff --git a/tests/Feature/Services/Social/ConnectionVerifierTest.php b/tests/Feature/Services/Social/ConnectionVerifierTest.php
index 48a86d792..96730ceea 100644
--- a/tests/Feature/Services/Social/ConnectionVerifierTest.php
+++ b/tests/Feature/Services/Social/ConnectionVerifierTest.php
@@ -1200,3 +1200,41 @@
 
     Http::assertSentCount(1);
 });
+
+test('verify succeeds for a healthy google business token', function () {
+    $account = SocialAccount::factory()->googleBusiness()->create();
+
+    Http::fake([
+        config('trypost.platforms.google_business.business_information_api').'/*' => Http::response(['name' => $account->meta['location_id']], 200),
+    ]);
+
+    expect(app(ConnectionVerifier::class)->verify($account))->toBeTrue();
+});
+
+test('verify throws token expired for a dead google business token', function () {
+    $account = SocialAccount::factory()->googleBusiness()->create();
+
+    Http::fake([
+        config('trypost.platforms.google_business.business_information_api').'/*' => Http::response(['error' => ['status' => 'UNAUTHENTICATED']], 401),
+        config('trypost.platforms.google_business.oauth_api').'/token' => Http::response(['error' => 'invalid_grant'], 400),
+    ]);
+
+    expect(fn () => app(ConnectionVerifier::class)->verify($account))->toThrow(TokenExpiredException::class);
+});
+
+test('refreshToken exchanges the refresh token for a new access token', function () {
+    $account = SocialAccount::factory()->googleBusiness()->create([
+        'refresh_token' => 'refresh-abc',
+    ]);
+
+    Http::fake([
+        config('trypost.platforms.google_business.oauth_api').'/token' => Http::response([
+            'access_token' => 'new-access-token',
+            'expires_in' => 3600,
+        ], 200),
+    ]);
+
+    app(ConnectionVerifier::class)->refreshToken($account);
+
+    expect($account->fresh()->access_token)->toBe('new-access-token');
+});

From d3c80ff67f134eaae0c962f93afa59c8061c05df Mon Sep 17 00:00:00 2001
From: Paulo Castellano <paulo@castellanos.llc>
Date: Mon, 10 Aug 2026 23:38:41 -0300
Subject: [PATCH 10/47] feat: dispatch Google Business Profile posts through
 the publish job

---
 app/Jobs/PublishToSocialPlatform.php          |  4 +++-
 .../Jobs/PublishToSocialPlatformTest.php      | 20 +++++++++++++++++++
 2 files changed, 23 insertions(+), 1 deletion(-)

diff --git a/app/Jobs/PublishToSocialPlatform.php b/app/Jobs/PublishToSocialPlatform.php
index 27a3a90e3..3725ac49a 100644
--- a/app/Jobs/PublishToSocialPlatform.php
+++ b/app/Jobs/PublishToSocialPlatform.php
@@ -21,6 +21,7 @@
 use App\Services\Social\ConnectionVerifier;
 use App\Services\Social\Discord\DiscordPublisher;
 use App\Services\Social\FacebookPublisher;
+use App\Services\Social\GoogleBusinessPublisher;
 use App\Services\Social\InstagramPublisher;
 use App\Services\Social\LinkedInPagePublisher;
 use App\Services\Social\LinkedInPublisher;
@@ -275,7 +276,7 @@ private function safeFailureMessage(\Throwable $e): string
             : 'An unexpected error occurred while publishing. Please try again.';
     }
 
-    private function getPublisher(): LinkedInPublisher|LinkedInPagePublisher|XPublisher|TikTokPublisher|YouTubePublisher|FacebookPublisher|InstagramPublisher|ThreadsPublisher|PinterestPublisher|BlueskyPublisher|MastodonPublisher|TelegramPublisher|DiscordPublisher
+    private function getPublisher(): LinkedInPublisher|LinkedInPagePublisher|XPublisher|TikTokPublisher|YouTubePublisher|FacebookPublisher|InstagramPublisher|ThreadsPublisher|PinterestPublisher|BlueskyPublisher|MastodonPublisher|TelegramPublisher|DiscordPublisher|GoogleBusinessPublisher
     {
         return match ($this->postPlatform->platform) {
             SocialPlatform::LinkedIn => app(LinkedInPublisher::class),
@@ -291,6 +292,7 @@ private function getPublisher(): LinkedInPublisher|LinkedInPagePublisher|XPublis
             SocialPlatform::Mastodon => app(MastodonPublisher::class),
             SocialPlatform::Telegram => app(TelegramPublisher::class),
             SocialPlatform::Discord => app(DiscordPublisher::class),
+            SocialPlatform::GoogleBusiness => app(GoogleBusinessPublisher::class),
         };
     }
 
diff --git a/tests/Feature/Jobs/PublishToSocialPlatformTest.php b/tests/Feature/Jobs/PublishToSocialPlatformTest.php
index 97d516212..b20a4170b 100644
--- a/tests/Feature/Jobs/PublishToSocialPlatformTest.php
+++ b/tests/Feature/Jobs/PublishToSocialPlatformTest.php
@@ -1025,3 +1025,23 @@
     expect($this->postPlatform->error_context['category'])->toBe('token_expired');
     expect($this->postPlatform->error_context['platform_error_code'])->toBe('190');
 });
+
+test('dispatches google business posts to GoogleBusinessPublisher', function () {
+    $account = SocialAccount::factory()->googleBusiness()->create([
+        'workspace_id' => $this->workspace->id,
+        'token_expires_at' => now()->addHour(),
+    ]);
+    $postPlatform = PostPlatform::factory()->googleBusiness()->create([
+        'post_id' => $this->post->id,
+        'social_account_id' => $account->id,
+        'meta' => ['topic_type' => 'STANDARD'],
+    ]);
+
+    Http::fake([
+        config('trypost.platforms.google_business.local_posts_api').'/*' => Http::response(['name' => 'accounts/1/locations/2/localPosts/3'], 200),
+    ]);
+
+    (new PublishToSocialPlatform($postPlatform))->handle();
+
+    expect($postPlatform->fresh()->status)->toBe(PlatformStatus::Published);
+});

From 2aede14247528748e89187180f3bd078a87cc128 Mon Sep 17 00:00:00 2001
From: Paulo Castellano <paulo@castellanos.llc>
Date: Mon, 10 Aug 2026 23:50:01 -0300
Subject: [PATCH 11/47] feat: add Google Business Profile OAuth connect flow

Adds GoogleBusinessController with connect/callback/select-location/select
routes, mirroring FacebookController's auto-connect-on-single-location and
picker-on-multiple pattern. Registers the 'google-business' Socialite driver
(separate from 'google-auth' and YouTube's 'google') and adds the required
i18n keys across all 16 locales.
---
 .../Auth/GoogleBusinessController.php         | 251 ++++++++++++++
 app/Providers/AppServiceProvider.php          |   7 +
 lang/ar/accounts.php                          |  12 +
 lang/de/accounts.php                          |  12 +
 lang/el/accounts.php                          |  12 +
 lang/en/accounts.php                          |  12 +
 lang/es/accounts.php                          |  12 +
 lang/fr/accounts.php                          |  12 +
 lang/it/accounts.php                          |  12 +
 lang/ja/accounts.php                          |  12 +
 lang/ko/accounts.php                          |  12 +
 lang/nl/accounts.php                          |  12 +
 lang/pl/accounts.php                          |  12 +
 lang/pt-BR/accounts.php                       |  12 +
 lang/ru/accounts.php                          |  12 +
 lang/tr/accounts.php                          |  12 +
 lang/uk/accounts.php                          |  12 +
 lang/zh/accounts.php                          |  12 +
 routes/app.php                                |   6 +
 .../Social/GoogleBusinessControllerTest.php   | 305 ++++++++++++++++++
 20 files changed, 761 insertions(+)
 create mode 100644 app/Http/Controllers/Auth/GoogleBusinessController.php
 create mode 100644 tests/Feature/Social/GoogleBusinessControllerTest.php

diff --git a/app/Http/Controllers/Auth/GoogleBusinessController.php b/app/Http/Controllers/Auth/GoogleBusinessController.php
new file mode 100644
index 000000000..451eee403
--- /dev/null
+++ b/app/Http/Controllers/Auth/GoogleBusinessController.php
@@ -0,0 +1,251 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Http\Controllers\Auth;
+
+use App\Enums\SocialAccount\Platform as SocialPlatform;
+use App\Enums\SocialAccount\Status;
+use App\Exceptions\SocialAccount\NetworkAlreadyConnectedException;
+use App\Models\Workspace;
+use App\Services\Social\GoogleBusinessPublisher;
+use Illuminate\Http\RedirectResponse;
+use Illuminate\Http\Request;
+use Illuminate\Support\Facades\Log;
+use Inertia\Inertia;
+use Inertia\Response as InertiaResponse;
+use Laravel\Socialite\Facades\Socialite;
+use Symfony\Component\HttpFoundation\Response;
+
+class GoogleBusinessController extends SocialController
+{
+    protected string $driver = 'google-business';
+
+    protected SocialPlatform $platform = SocialPlatform::GoogleBusiness;
+
+    protected array $scopes = [
+        'https://www.googleapis.com/auth/userinfo.profile',
+        'https://www.googleapis.com/auth/userinfo.email',
+        'https://www.googleapis.com/auth/business.manage',
+    ];
+
+    public function __construct(private readonly GoogleBusinessPublisher $publisher) {}
+
+    public function connect(Request $request): Response
+    {
+        $this->ensurePlatformEnabled();
+
+        $workspace = $request->user()->currentWorkspace;
+
+        $this->authorize('manageAccounts', $workspace);
+
+        session([
+            'social_connect_workspace' => $workspace->id,
+            'social_reconnect_id' => null,
+        ]);
+
+        return $this->redirectToGoogle();
+    }
+
+    public function callback(Request $request): InertiaResponse|RedirectResponse
+    {
+        $workspaceId = session('social_connect_workspace');
+
+        if (! $workspaceId) {
+            return $this->popupCallback(false, __('accounts.popup_callback.session_expired'), $this->platform->value);
+        }
+
+        $workspace = Workspace::find($workspaceId);
+
+        if (! $workspace || ! $request->user()->can('manageAccounts', $workspace)) {
+            return $this->popupCallback(false, __('accounts.popup_callback.workspace_not_found'), $this->platform->value);
+        }
+
+        try {
+            $socialUser = Socialite::driver($this->driver)->user();
+
+            $locations = $this->publisher->fetchLocations($socialUser->token);
+
+            if (empty($locations)) {
+                return $this->popupCallback(false, __('accounts.popup_callback.no_google_business_locations'), $this->platform->value);
+            }
+
+            if (count($locations) === 1) {
+                $this->connectLocation($workspace, $locations[0], $socialUser->token, $socialUser->refreshToken, $socialUser->expiresIn, $socialUser->getId());
+
+                return $this->popupCallback(true, __('accounts.popup_callback.connected'), $this->platform->value);
+            }
+
+            session([
+                'google_business_oauth' => [
+                    'access_token' => $socialUser->token,
+                    'refresh_token' => $socialUser->refreshToken,
+                    'expires_in' => $socialUser->expiresIn,
+                    'user_id' => $socialUser->getId(),
+                ],
+            ]);
+
+            return redirect()->route('app.social.google-business.select-location');
+        } catch (NetworkAlreadyConnectedException) {
+            return $this->popupCallback(false, __('accounts.popup_callback.network_taken'), $this->platform->value);
+        } catch (\Exception $e) {
+            Log::error('Google Business Profile OAuth Error', [
+                'error' => $e->getMessage(),
+                'trace' => $e->getTraceAsString(),
+            ]);
+
+            return $this->popupCallback(false, __('accounts.popup_callback.error_connecting'), $this->platform->value);
+        }
+    }
+
+    public function selectLocation(Request $request): InertiaResponse
+    {
+        $oauthData = session('google_business_oauth');
+        $workspaceId = session('social_connect_workspace');
+
+        if (! $oauthData || ! $workspaceId) {
+            return $this->popupCallback(false, __('accounts.popup_callback.session_expired'), $this->platform->value);
+        }
+
+        $workspace = Workspace::find($workspaceId);
+
+        if (! $workspace) {
+            return $this->popupCallback(false, __('accounts.popup_callback.workspace_not_found'), $this->platform->value);
+        }
+
+        $locations = $this->publisher->fetchLocations(data_get($oauthData, 'access_token'));
+
+        if (empty($locations)) {
+            $this->forgetSocialConnectSession();
+            session()->forget('google_business_oauth');
+
+            return $this->popupCallback(false, __('accounts.popup_callback.no_google_business_locations'), $this->platform->value);
+        }
+
+        return Inertia::render('accounts/GoogleBusinessLocationSelect', [
+            'workspace' => $workspace,
+            'locations' => $locations,
+        ]);
+    }
+
+    public function select(Request $request): InertiaResponse
+    {
+        $request->validate([
+            'location_id' => 'required|string',
+        ]);
+
+        $oauthData = session('google_business_oauth');
+        $workspaceId = session('social_connect_workspace');
+
+        if (! $oauthData || ! $workspaceId) {
+            return $this->popupCallback(false, __('accounts.popup_callback.session_expired'), $this->platform->value);
+        }
+
+        $workspace = Workspace::find($workspaceId);
+
+        if (! $workspace || ! $request->user()->can('manageAccounts', $workspace)) {
+            return $this->popupCallback(false, __('accounts.popup_callback.workspace_not_found'), $this->platform->value);
+        }
+
+        try {
+            $locations = $this->publisher->fetchLocations(data_get($oauthData, 'access_token'));
+            $selectedLocation = collect($locations)->firstWhere('id', $request->location_id);
+
+            if (! $selectedLocation) {
+                return $this->popupCallback(false, __('accounts.popup_callback.location_not_found'), $this->platform->value);
+            }
+
+            $reconnectId = data_get($oauthData, 'reconnect_id');
+
+            if ($reconnectId) {
+                $existingAccount = $workspace->socialAccounts()->find($reconnectId);
+
+                if ($existingAccount) {
+                    $existingAccount->update([
+                        'platform_user_id' => data_get($selectedLocation, 'id'),
+                        'username' => data_get($selectedLocation, 'title'),
+                        'display_name' => data_get($selectedLocation, 'title'),
+                        'access_token' => data_get($oauthData, 'access_token'),
+                        'refresh_token' => data_get($oauthData, 'refresh_token'),
+                        'token_expires_at' => data_get($oauthData, 'expires_in') ? now()->addSeconds(data_get($oauthData, 'expires_in')) : null,
+                        'scopes' => $this->scopes,
+                        'meta' => [
+                            'location_id' => data_get($selectedLocation, 'id'),
+                            'account_name' => data_get($selectedLocation, 'account_name'),
+                            'location_name' => data_get($selectedLocation, 'location_name'),
+                            'google_user_id' => data_get($oauthData, 'user_id'),
+                        ],
+                    ]);
+                    $existingAccount->markAsConnected();
+
+                    session()->forget(['google_business_oauth', 'social_reconnect_id']);
+
+                    return $this->popupCallback(true, __('accounts.popup_callback.reconnected'), $this->platform->value);
+                }
+            }
+
+            $this->connectLocation(
+                $workspace,
+                $selectedLocation,
+                data_get($oauthData, 'access_token'),
+                data_get($oauthData, 'refresh_token'),
+                data_get($oauthData, 'expires_in'),
+                data_get($oauthData, 'user_id'),
+            );
+
+            session()->forget(['google_business_oauth', 'social_reconnect_id']);
+
+            return $this->popupCallback(true, __('accounts.popup_callback.connected'), $this->platform->value);
+        } catch (NetworkAlreadyConnectedException) {
+            return $this->popupCallback(false, __('accounts.popup_callback.network_taken'), $this->platform->value);
+        } catch (\Exception $e) {
+            Log::error('Google Business Profile location selection error', [
+                'error' => $e->getMessage(),
+            ]);
+
+            return $this->popupCallback(false, __('accounts.popup_callback.error_connecting_location'), $this->platform->value);
+        }
+    }
+
+    private function connectLocation(Workspace $workspace, array $location, string $accessToken, ?string $refreshToken, ?int $expiresIn, ?string $googleUserId): void
+    {
+        $workspace->socialAccounts()->updateOrCreate(
+            [
+                'platform' => $this->platform->value,
+                'platform_user_id' => data_get($location, 'id'),
+            ],
+            [
+                'username' => data_get($location, 'title'),
+                'display_name' => data_get($location, 'title'),
+                'access_token' => $accessToken,
+                'refresh_token' => $refreshToken,
+                'token_expires_at' => $expiresIn ? now()->addSeconds($expiresIn) : null,
+                'scopes' => $this->scopes,
+                'status' => Status::Connected,
+                'error_message' => null,
+                'disconnected_at' => null,
+                'meta' => [
+                    'location_id' => data_get($location, 'id'),
+                    'account_name' => data_get($location, 'account_name'),
+                    'location_name' => data_get($location, 'location_name'),
+                    'google_user_id' => $googleUserId,
+                ],
+            ],
+        );
+    }
+
+    private function redirectToGoogle(): Response
+    {
+        return Inertia::location(
+            Socialite::driver($this->driver)
+                ->scopes($this->scopes)
+                ->with([
+                    'access_type' => 'offline',
+                    'prompt' => 'consent',
+                    'include_granted_scopes' => 'true',
+                ])
+                ->redirect()
+                ->getTargetUrl()
+        );
+    }
+}
diff --git a/app/Providers/AppServiceProvider.php b/app/Providers/AppServiceProvider.php
index 2f18e9068..350b4b4e5 100644
--- a/app/Providers/AppServiceProvider.php
+++ b/app/Providers/AppServiceProvider.php
@@ -188,6 +188,13 @@ protected function configureSocialite(): void
             return Socialite::buildProvider(GoogleProvider::class, $config);
         });
 
+        // Google Business Profile — dedicated app, separate from 'google' (YouTube).
+        Socialite::extend('google-business', function ($app) {
+            $config = $app['config']['services.google-business'];
+
+            return Socialite::buildProvider(GoogleProvider::class, $config);
+        });
+
         // Instagram Business Login
         Socialite::extend('instagram', function ($app) {
             $config = $app['config']['services.instagram'];
diff --git a/lang/ar/accounts.php b/lang/ar/accounts.php
index 46971781f..a323eb9e2 100644
--- a/lang/ar/accounts.php
+++ b/lang/ar/accounts.php
@@ -29,6 +29,7 @@
         'mastodon' => 'اربط حسابك على Mastodon',
         'telegram' => 'اربط قناة أو مجموعة على Telegram',
         'discord' => 'اربط خادم Discord',
+        'google_business' => 'اربط موقع Google Business Profile',
     ],
 
     'disconnect_modal' => [
@@ -153,5 +154,16 @@
         'no_facebook_instagram_pages' => 'لم يتم العثور على صفحات Facebook مرتبطة بحسابات Instagram.',
         'no_youtube_channels' => 'لم يتم العثور على قنوات YouTube. يرجى إنشاء قناة أولًا.',
         'not_linkedin_admin' => 'أنت لست مشرفًا على أي صفحة LinkedIn.',
+        'no_google_business_locations' => 'لم يتم العثور على مواقع Google Business Profile. يرجى التحقق من نشاطك التجاري أولاً.',
+        'location_not_found' => 'الموقع غير موجود.',
+        'error_connecting_location' => 'خطأ في ربط الموقع. يرجى المحاولة مرة أخرى.',
+    ],
+
+    'google_business' => [
+        'title' => 'اختر موقع النشاط التجاري',
+        'description' => 'اختر الموقع الذي تريد ربطه',
+        'no_locations' => 'لم يتم العثور على مواقع',
+        'no_locations_description' => 'أنت لست مديرًا لأي موقع تم التحقق منه في Google Business Profile.',
+        'choose' => 'اختيار',
     ],
 ];
diff --git a/lang/de/accounts.php b/lang/de/accounts.php
index efb4801bb..cd4fbae8f 100644
--- a/lang/de/accounts.php
+++ b/lang/de/accounts.php
@@ -31,6 +31,7 @@
         'mastodon' => 'Verbinde dein Mastodon-Konto',
         'telegram' => 'Verbinde einen Telegram-Kanal oder eine Telegram-Gruppe',
         'discord' => 'Verbinde einen Discord-Server',
+        'google_business' => 'Verbinde einen Google Unternehmensprofil-Standort',
     ],
 
     'disconnect_modal' => [
@@ -155,5 +156,16 @@
         'no_facebook_instagram_pages' => 'Keine Facebook-Seiten mit verknüpften Instagram-Konten gefunden.',
         'no_youtube_channels' => 'Keine YouTube-Kanäle gefunden. Bitte erstelle zuerst einen Kanal.',
         'not_linkedin_admin' => 'Du bist kein Administrator einer LinkedIn-Seite.',
+        'no_google_business_locations' => 'Keine Google Unternehmensprofil-Standorte gefunden. Bestätige zuerst dein Unternehmen.',
+        'location_not_found' => 'Standort nicht gefunden.',
+        'error_connecting_location' => 'Fehler beim Verbinden des Standorts. Bitte versuche es erneut.',
+    ],
+
+    'google_business' => [
+        'title' => 'Standort auswählen',
+        'description' => 'Wähle aus, welchen Standort du verbinden möchtest',
+        'no_locations' => 'Keine Standorte gefunden',
+        'no_locations_description' => 'Du bist kein Manager eines verifizierten Google Unternehmensprofil-Standorts.',
+        'choose' => 'Auswählen',
     ],
 ];
diff --git a/lang/el/accounts.php b/lang/el/accounts.php
index e94adbd11..2626966fe 100644
--- a/lang/el/accounts.php
+++ b/lang/el/accounts.php
@@ -29,6 +29,7 @@
         'mastodon' => 'Συνδέστε τον λογαριασμό σας Mastodon',
         'telegram' => 'Συνδέστε ένα κανάλι ή ομάδα Telegram',
         'discord' => 'Συνδέστε έναν διακομιστή Discord',
+        'google_business' => 'Συνδέστε μια τοποθεσία Google Business Profile',
     ],
 
     'disconnect_modal' => [
@@ -153,5 +154,16 @@
         'no_facebook_instagram_pages' => 'Δεν βρέθηκαν σελίδες Facebook με συνδεδεμένους λογαριασμούς Instagram.',
         'no_youtube_channels' => 'Δεν βρέθηκαν κανάλια YouTube. Παρακαλούμε δημιουργήστε πρώτα ένα κανάλι.',
         'not_linkedin_admin' => 'Δεν είστε διαχειριστής καμίας σελίδας LinkedIn.',
+        'no_google_business_locations' => 'Δεν βρέθηκαν τοποθεσίες Google Business Profile. Επαληθεύστε πρώτα την επιχείρησή σας.',
+        'location_not_found' => 'Η τοποθεσία δεν βρέθηκε.',
+        'error_connecting_location' => 'Σφάλμα κατά τη σύνδεση της τοποθεσίας. Δοκιμάστε ξανά.',
+    ],
+
+    'google_business' => [
+        'title' => 'Επιλογή Τοποθεσίας Επιχείρησης',
+        'description' => 'Επιλέξτε ποια τοποθεσία θέλετε να συνδέσετε',
+        'no_locations' => 'Δεν βρέθηκαν τοποθεσίες',
+        'no_locations_description' => 'Δεν είστε διαχειριστής καμίας επαληθευμένης τοποθεσίας Google Business Profile.',
+        'choose' => 'Επιλογή',
     ],
 ];
diff --git a/lang/en/accounts.php b/lang/en/accounts.php
index 6ab145525..fecb6d455 100644
--- a/lang/en/accounts.php
+++ b/lang/en/accounts.php
@@ -29,6 +29,7 @@
         'mastodon' => 'Connect your Mastodon account',
         'telegram' => 'Connect a Telegram channel or group',
         'discord' => 'Connect a Discord server',
+        'google_business' => 'Connect a Google Business Profile location',
     ],
 
     'disconnect_modal' => [
@@ -153,5 +154,16 @@
         'no_facebook_instagram_pages' => 'No Facebook Pages with linked Instagram accounts found.',
         'no_youtube_channels' => 'No YouTube channels found. Please create a channel first.',
         'not_linkedin_admin' => 'You are not an administrator of any LinkedIn page.',
+        'no_google_business_locations' => 'No Google Business Profile locations found. Verify your business first.',
+        'location_not_found' => 'Location not found.',
+        'error_connecting_location' => 'Error connecting location. Please try again.',
+    ],
+
+    'google_business' => [
+        'title' => 'Select Business Location',
+        'description' => 'Choose which location you want to connect',
+        'no_locations' => 'No locations found',
+        'no_locations_description' => 'You are not a manager of any verified Google Business Profile location.',
+        'choose' => 'Choose',
     ],
 ];
diff --git a/lang/es/accounts.php b/lang/es/accounts.php
index 38a93d016..1374e0fb4 100644
--- a/lang/es/accounts.php
+++ b/lang/es/accounts.php
@@ -29,6 +29,7 @@
         'mastodon' => 'Conecta tu cuenta de Mastodon',
         'telegram' => 'Conecta un canal o grupo de Telegram',
         'discord' => 'Conecta un servidor de Discord',
+        'google_business' => 'Conecta una ubicación de Google Business Profile',
     ],
 
     'disconnect_modal' => [
@@ -153,5 +154,16 @@
         'no_facebook_instagram_pages' => 'No se encontraron páginas de Facebook con cuentas de Instagram vinculadas.',
         'no_youtube_channels' => 'No se encontraron canales de YouTube. Crea un canal primero.',
         'not_linkedin_admin' => 'No eres administrador de ninguna página de LinkedIn.',
+        'no_google_business_locations' => 'No se encontraron ubicaciones de Google Business Profile. Verifica tu negocio primero.',
+        'location_not_found' => 'Ubicación no encontrada.',
+        'error_connecting_location' => 'Error al conectar la ubicación. Por favor, inténtalo de nuevo.',
+    ],
+
+    'google_business' => [
+        'title' => 'Seleccionar Ubicación del Negocio',
+        'description' => 'Elige qué ubicación quieres conectar',
+        'no_locations' => 'No se encontraron ubicaciones',
+        'no_locations_description' => 'No eres administrador de ninguna ubicación verificada de Google Business Profile.',
+        'choose' => 'Elegir',
     ],
 ];
diff --git a/lang/fr/accounts.php b/lang/fr/accounts.php
index 8e37fc69b..1e464d374 100644
--- a/lang/fr/accounts.php
+++ b/lang/fr/accounts.php
@@ -29,6 +29,7 @@
         'mastodon' => 'Connectez votre compte Mastodon',
         'telegram' => 'Connectez un canal ou un groupe Telegram',
         'discord' => 'Connectez un serveur Discord',
+        'google_business' => 'Connectez un établissement Google Business Profile',
     ],
 
     'disconnect_modal' => [
@@ -153,5 +154,16 @@
         'no_facebook_instagram_pages' => 'Aucune page Facebook associée à un compte Instagram trouvée.',
         'no_youtube_channels' => 'Aucune chaîne YouTube trouvée. Veuillez d\'abord créer une chaîne.',
         'not_linkedin_admin' => 'Vous n\'êtes administrateur d\'aucune page LinkedIn.',
+        'no_google_business_locations' => 'Aucun établissement Google Business Profile trouvé. Vérifiez d\'abord votre établissement.',
+        'location_not_found' => 'Établissement introuvable.',
+        'error_connecting_location' => 'Erreur lors de la connexion de l\'établissement. Veuillez réessayer.',
+    ],
+
+    'google_business' => [
+        'title' => 'Sélectionner l\'établissement',
+        'description' => 'Choisissez l\'établissement que vous souhaitez connecter',
+        'no_locations' => 'Aucun établissement trouvé',
+        'no_locations_description' => 'Vous n\'êtes gestionnaire d\'aucun établissement Google Business Profile vérifié.',
+        'choose' => 'Choisir',
     ],
 ];
diff --git a/lang/it/accounts.php b/lang/it/accounts.php
index b362705a1..e1f112085 100644
--- a/lang/it/accounts.php
+++ b/lang/it/accounts.php
@@ -29,6 +29,7 @@
         'mastodon' => 'Collega il tuo account Mastodon',
         'telegram' => 'Collega un canale o gruppo Telegram',
         'discord' => 'Collega un server Discord',
+        'google_business' => 'Collega una sede di Google Business Profile',
     ],
 
     'disconnect_modal' => [
@@ -153,5 +154,16 @@
         'no_facebook_instagram_pages' => 'Nessuna pagina Facebook con account Instagram collegati trovata.',
         'no_youtube_channels' => 'Nessun canale YouTube trovato. Crea prima un canale.',
         'not_linkedin_admin' => 'Non sei amministratore di alcuna pagina LinkedIn.',
+        'no_google_business_locations' => 'Nessuna sede di Google Business Profile trovata. Verifica prima la tua attività.',
+        'location_not_found' => 'Sede non trovata.',
+        'error_connecting_location' => 'Errore nella connessione della sede. Riprova.',
+    ],
+
+    'google_business' => [
+        'title' => 'Seleziona Sede Attività',
+        'description' => 'Scegli quale sede vuoi collegare',
+        'no_locations' => 'Nessuna sede trovata',
+        'no_locations_description' => 'Non sei gestore di nessuna sede verificata di Google Business Profile.',
+        'choose' => 'Scegli',
     ],
 ];
diff --git a/lang/ja/accounts.php b/lang/ja/accounts.php
index 4ca6e41df..de35ba2ed 100644
--- a/lang/ja/accounts.php
+++ b/lang/ja/accounts.php
@@ -29,6 +29,7 @@
         'mastodon' => 'Mastodon アカウントを接続',
         'telegram' => 'Telegram チャンネルまたはグループを接続',
         'discord' => 'Discord サーバーを接続',
+        'google_business' => 'Google ビジネス プロフィールの店舗を接続',
     ],
 
     'disconnect_modal' => [
@@ -153,5 +154,16 @@
         'no_facebook_instagram_pages' => 'Instagram アカウントが連携された Facebook ページが見つかりません。',
         'no_youtube_channels' => 'YouTube チャンネルが見つかりません。先にチャンネルを作成してください。',
         'not_linkedin_admin' => 'あなたは管理者となっている LinkedIn ページがありません。',
+        'no_google_business_locations' => 'Google ビジネス プロフィールの店舗が見つかりません。まずビジネスを確認してください。',
+        'location_not_found' => '店舗が見つかりません。',
+        'error_connecting_location' => '店舗の接続中にエラーが発生しました。もう一度お試しください。',
+    ],
+
+    'google_business' => [
+        'title' => 'ビジネス店舗を選択',
+        'description' => '接続する店舗を選択してください',
+        'no_locations' => '店舗が見つかりません',
+        'no_locations_description' => '確認済みの Google ビジネス プロフィール店舗の管理者ではありません。',
+        'choose' => '選択',
     ],
 ];
diff --git a/lang/ko/accounts.php b/lang/ko/accounts.php
index 89ad4b751..3a264488c 100644
--- a/lang/ko/accounts.php
+++ b/lang/ko/accounts.php
@@ -29,6 +29,7 @@
         'mastodon' => 'Mastodon 계정을 연결하세요',
         'telegram' => 'Telegram 채널 또는 그룹을 연결하세요',
         'discord' => 'Discord 서버를 연결하세요',
+        'google_business' => 'Google 비즈니스 프로필 위치를 연결하세요',
     ],
 
     'disconnect_modal' => [
@@ -153,5 +154,16 @@
         'no_facebook_instagram_pages' => 'Instagram 계정이 연결된 Facebook 페이지를 찾을 수 없습니다.',
         'no_youtube_channels' => 'YouTube 채널을 찾을 수 없습니다. 먼저 채널을 만드세요.',
         'not_linkedin_admin' => '관리자로 있는 LinkedIn 페이지가 없습니다.',
+        'no_google_business_locations' => 'Google 비즈니스 프로필 위치를 찾을 수 없습니다. 먼저 비즈니스를 인증하세요.',
+        'location_not_found' => '위치를 찾을 수 없습니다.',
+        'error_connecting_location' => '위치 연결 중 오류가 발생했습니다. 다시 시도해 주세요.',
+    ],
+
+    'google_business' => [
+        'title' => '비즈니스 위치 선택',
+        'description' => '연결할 위치를 선택하세요',
+        'no_locations' => '위치를 찾을 수 없습니다',
+        'no_locations_description' => '인증된 Google 비즈니스 프로필 위치의 관리자가 아닙니다.',
+        'choose' => '선택',
     ],
 ];
diff --git a/lang/nl/accounts.php b/lang/nl/accounts.php
index c5c8f45e3..292284a53 100644
--- a/lang/nl/accounts.php
+++ b/lang/nl/accounts.php
@@ -29,6 +29,7 @@
         'mastodon' => 'Koppel je Mastodon-account',
         'telegram' => 'Koppel een Telegram-kanaal of -groep',
         'discord' => 'Koppel een Discord-server',
+        'google_business' => 'Koppel een Google Bedrijfsprofiel-locatie',
     ],
 
     'disconnect_modal' => [
@@ -153,5 +154,16 @@
         'no_facebook_instagram_pages' => 'Geen Facebook-pagina\'s met gekoppelde Instagram-accounts gevonden.',
         'no_youtube_channels' => 'Geen YouTube-kanalen gevonden. Maak eerst een kanaal aan.',
         'not_linkedin_admin' => 'Je bent geen beheerder van een LinkedIn-pagina.',
+        'no_google_business_locations' => 'Geen Google Bedrijfsprofiel-locaties gevonden. Verifieer eerst je bedrijf.',
+        'location_not_found' => 'Locatie niet gevonden.',
+        'error_connecting_location' => 'Fout bij het koppelen van de locatie. Probeer het opnieuw.',
+    ],
+
+    'google_business' => [
+        'title' => 'Selecteer Bedrijfslocatie',
+        'description' => 'Kies welke locatie je wilt koppelen',
+        'no_locations' => 'Geen locaties gevonden',
+        'no_locations_description' => 'Je bent geen beheerder van een geverifieerde Google Bedrijfsprofiel-locatie.',
+        'choose' => 'Kiezen',
     ],
 ];
diff --git a/lang/pl/accounts.php b/lang/pl/accounts.php
index 0828de36e..90ed8230c 100644
--- a/lang/pl/accounts.php
+++ b/lang/pl/accounts.php
@@ -29,6 +29,7 @@
         'mastodon' => 'Połącz swoje konto Mastodon',
         'telegram' => 'Połącz kanał lub grupę na Telegramie',
         'discord' => 'Połącz serwer Discord',
+        'google_business' => 'Połącz lokalizację Google Business Profile',
     ],
 
     'disconnect_modal' => [
@@ -153,5 +154,16 @@
         'no_facebook_instagram_pages' => 'Nie znaleziono stron na Facebooku z powiązanymi kontami Instagram.',
         'no_youtube_channels' => 'Nie znaleziono kanałów YouTube. Najpierw utwórz kanał.',
         'not_linkedin_admin' => 'Nie jesteś administratorem żadnej strony LinkedIn.',
+        'no_google_business_locations' => 'Nie znaleziono lokalizacji Google Business Profile. Najpierw zweryfikuj swoją firmę.',
+        'location_not_found' => 'Nie znaleziono lokalizacji.',
+        'error_connecting_location' => 'Błąd podczas łączenia lokalizacji. Spróbuj ponownie.',
+    ],
+
+    'google_business' => [
+        'title' => 'Wybierz lokalizację firmy',
+        'description' => 'Wybierz, którą lokalizację chcesz połączyć',
+        'no_locations' => 'Nie znaleziono lokalizacji',
+        'no_locations_description' => 'Nie jesteś menedżerem żadnej zweryfikowanej lokalizacji Google Business Profile.',
+        'choose' => 'Wybierz',
     ],
 ];
diff --git a/lang/pt-BR/accounts.php b/lang/pt-BR/accounts.php
index 4531dcdd1..c1b159f13 100644
--- a/lang/pt-BR/accounts.php
+++ b/lang/pt-BR/accounts.php
@@ -29,6 +29,7 @@
         'mastodon' => 'Conecte sua conta do Mastodon',
         'telegram' => 'Conecte um canal ou grupo do Telegram',
         'discord' => 'Conecte um servidor do Discord',
+        'google_business' => 'Conecte um local do Google Business Profile',
     ],
 
     'disconnect_modal' => [
@@ -153,5 +154,16 @@
         'no_facebook_instagram_pages' => 'Nenhuma página do Facebook com conta do Instagram vinculada foi encontrada.',
         'no_youtube_channels' => 'Nenhum canal do YouTube encontrado. Por favor, crie um canal primeiro.',
         'not_linkedin_admin' => 'Você não é administrador de nenhuma página do LinkedIn.',
+        'no_google_business_locations' => 'Nenhum local do Google Business Profile encontrado. Verifique sua empresa primeiro.',
+        'location_not_found' => 'Local não encontrado.',
+        'error_connecting_location' => 'Erro ao conectar local. Por favor, tente novamente.',
+    ],
+
+    'google_business' => [
+        'title' => 'Selecionar Local Comercial',
+        'description' => 'Escolha qual local você deseja conectar',
+        'no_locations' => 'Nenhum local encontrado',
+        'no_locations_description' => 'Você não é gerente de nenhum local verificado do Google Business Profile.',
+        'choose' => 'Escolher',
     ],
 ];
diff --git a/lang/ru/accounts.php b/lang/ru/accounts.php
index 384a0c430..c90ef729e 100644
--- a/lang/ru/accounts.php
+++ b/lang/ru/accounts.php
@@ -29,6 +29,7 @@
         'mastodon' => 'Подключите аккаунт Mastodon',
         'telegram' => 'Подключите канал или группу Telegram',
         'discord' => 'Подключите сервер Discord',
+        'google_business' => 'Подключите местоположение Google Business Profile',
     ],
 
     'disconnect_modal' => [
@@ -153,5 +154,16 @@
         'no_facebook_instagram_pages' => 'Не найдено страниц Facebook со связанными аккаунтами Instagram.',
         'no_youtube_channels' => 'Каналы YouTube не найдены. Сначала создайте канал.',
         'not_linkedin_admin' => 'Вы не являетесь администратором ни одной страницы LinkedIn.',
+        'no_google_business_locations' => 'Местоположения Google Business Profile не найдены. Сначала подтвердите свою компанию.',
+        'location_not_found' => 'Местоположение не найдено.',
+        'error_connecting_location' => 'Ошибка при подключении местоположения. Пожалуйста, попробуйте снова.',
+    ],
+
+    'google_business' => [
+        'title' => 'Выберите местоположение компании',
+        'description' => 'Выберите местоположение, которое хотите подключить',
+        'no_locations' => 'Местоположения не найдены',
+        'no_locations_description' => 'Вы не являетесь менеджером ни одного подтверждённого местоположения Google Business Profile.',
+        'choose' => 'Выбрать',
     ],
 ];
diff --git a/lang/tr/accounts.php b/lang/tr/accounts.php
index e65d7b887..ac46b5ebb 100644
--- a/lang/tr/accounts.php
+++ b/lang/tr/accounts.php
@@ -31,6 +31,7 @@
         'mastodon' => 'Mastodon hesabınızı bağlayın',
         'telegram' => 'Bir Telegram kanalı veya grubu bağlayın',
         'discord' => 'Bir Discord sunucusu bağlayın',
+        'google_business' => 'Bir Google İşletme Profili konumu bağlayın',
     ],
 
     'disconnect_modal' => [
@@ -155,5 +156,16 @@
         'no_facebook_instagram_pages' => 'Bağlı Instagram hesabı olan Facebook Sayfası bulunamadı.',
         'no_youtube_channels' => 'YouTube kanalı bulunamadı. Lütfen önce bir kanal oluşturun.',
         'not_linkedin_admin' => 'Hiçbir LinkedIn sayfasının yöneticisi değilsiniz.',
+        'no_google_business_locations' => 'Google İşletme Profili konumu bulunamadı. Önce işletmenizi doğrulayın.',
+        'location_not_found' => 'Konum bulunamadı.',
+        'error_connecting_location' => 'Konum bağlanırken hata oluştu. Lütfen tekrar deneyin.',
+    ],
+
+    'google_business' => [
+        'title' => 'İşletme Konumu Seç',
+        'description' => 'Bağlamak istediğiniz konumu seçin',
+        'no_locations' => 'Konum bulunamadı',
+        'no_locations_description' => 'Doğrulanmış herhangi bir Google İşletme Profili konumunun yöneticisi değilsiniz.',
+        'choose' => 'Seç',
     ],
 ];
diff --git a/lang/uk/accounts.php b/lang/uk/accounts.php
index ae1a521f4..b9409e0e9 100644
--- a/lang/uk/accounts.php
+++ b/lang/uk/accounts.php
@@ -29,6 +29,7 @@
         'mastodon' => 'Підключіть акаунт Mastodon',
         'telegram' => 'Підключіть канал або групу Telegram',
         'discord' => 'Підключіть сервер Discord',
+        'google_business' => 'Підключіть місцезнаходження Google Business Profile',
     ],
 
     'disconnect_modal' => [
@@ -153,5 +154,16 @@
         'no_facebook_instagram_pages' => 'Не знайдено сторінок Facebook із підключеними акаунтами Instagram.',
         'no_youtube_channels' => 'Каналів YouTube не знайдено. Спочатку створіть канал.',
         'not_linkedin_admin' => 'Ви не є адміністратором жодної сторінки LinkedIn.',
+        'no_google_business_locations' => 'Місцезнаходження Google Business Profile не знайдено. Спочатку підтвердьте свій бізнес.',
+        'location_not_found' => 'Місцезнаходження не знайдено.',
+        'error_connecting_location' => 'Помилка під час підключення місцезнаходження. Спробуйте ще раз.',
+    ],
+
+    'google_business' => [
+        'title' => 'Виберіть місцезнаходження бізнесу',
+        'description' => 'Виберіть місцезнаходження, яке хочете підключити',
+        'no_locations' => 'Місцезнаходження не знайдено',
+        'no_locations_description' => 'Ви не є менеджером жодного підтвердженого місцезнаходження Google Business Profile.',
+        'choose' => 'Вибрати',
     ],
 ];
diff --git a/lang/zh/accounts.php b/lang/zh/accounts.php
index af05c84ea..6b3ad81b0 100644
--- a/lang/zh/accounts.php
+++ b/lang/zh/accounts.php
@@ -29,6 +29,7 @@
         'mastodon' => '连接你的 Mastodon 账号',
         'telegram' => '连接一个 Telegram 频道或群组',
         'discord' => '连接一个 Discord 服务器',
+        'google_business' => '连接一个 Google 商家资料位置',
     ],
 
     'disconnect_modal' => [
@@ -153,5 +154,16 @@
         'no_facebook_instagram_pages' => '未找到关联了 Instagram 账号的 Facebook 主页。',
         'no_youtube_channels' => '未找到 YouTube 频道，请先创建一个频道。',
         'not_linkedin_admin' => '你不是任何 LinkedIn 页面的管理员。',
+        'no_google_business_locations' => '未找到 Google 商家资料位置。请先验证您的企业。',
+        'location_not_found' => '未找到该位置。',
+        'error_connecting_location' => '连接位置时出错。请重试。',
+    ],
+
+    'google_business' => [
+        'title' => '选择商家位置',
+        'description' => '选择您要连接的位置',
+        'no_locations' => '未找到位置',
+        'no_locations_description' => '您不是任何已验证的 Google 商家资料位置的管理者。',
+        'choose' => '选择',
     ],
 ];
diff --git a/routes/app.php b/routes/app.php
index a6742a769..2b50f2f69 100644
--- a/routes/app.php
+++ b/routes/app.php
@@ -36,6 +36,7 @@
 use App\Http\Controllers\Auth\BlueskyController;
 use App\Http\Controllers\Auth\DiscordController;
 use App\Http\Controllers\Auth\FacebookController;
+use App\Http\Controllers\Auth\GoogleBusinessController;
 use App\Http\Controllers\Auth\InstagramController;
 use App\Http\Controllers\Auth\InstagramFacebookController;
 use App\Http\Controllers\Auth\LinkedInController;
@@ -107,6 +108,7 @@
         Route::post('connect/mastodon', [MastodonController::class, 'authorizeInstance'])->name('app.social.mastodon.authorize');
         Route::post('connect/telegram', [TelegramController::class, 'connect'])->name('app.social.telegram.connect');
         Route::get('connect/discord', [DiscordController::class, 'connect'])->name('app.social.discord.connect');
+        Route::get('connect/google-business', [GoogleBusinessController::class, 'connect'])->name('app.social.google-business.connect');
 
         Route::delete('accounts/{account}', [SocialController::class, 'disconnect'])->name('app.accounts.disconnect');
     });
@@ -146,6 +148,10 @@
     Route::get('accounts/mastodon/callback', [MastodonController::class, 'callback'])->name('app.social.mastodon.callback');
 
     Route::get('accounts/discord/callback', [DiscordController::class, 'callback'])->name('app.social.discord.callback');
+
+    Route::get('accounts/google-business/callback', [GoogleBusinessController::class, 'callback'])->name('app.social.google-business.callback');
+    Route::get('accounts/google-business/select', [GoogleBusinessController::class, 'selectLocation'])->name('app.social.google-business.select-location');
+    Route::post('accounts/google-business/select', [GoogleBusinessController::class, 'select'])->name('app.social.google-business.select');
 });
 
 // Routes that require account access and a current workspace
diff --git a/tests/Feature/Social/GoogleBusinessControllerTest.php b/tests/Feature/Social/GoogleBusinessControllerTest.php
new file mode 100644
index 000000000..75ebaaa72
--- /dev/null
+++ b/tests/Feature/Social/GoogleBusinessControllerTest.php
@@ -0,0 +1,305 @@
+<?php
+
+declare(strict_types=1);
+
+use App\Enums\SocialAccount\Platform;
+use App\Enums\SocialAccount\Status;
+use App\Enums\UserWorkspace\Role;
+use App\Models\SocialAccount;
+use App\Models\User;
+use App\Models\Workspace;
+use App\Services\Social\GoogleBusinessPublisher;
+use Inertia\Testing\AssertableInertia;
+use Laravel\Socialite\Facades\Socialite;
+use Laravel\Socialite\Two\User as SocialiteUser;
+
+beforeEach(function () {
+    $this->user = User::factory()->create();
+    $this->workspace = Workspace::factory()->create(['user_id' => $this->user->id]);
+    $this->user->update(['current_workspace_id' => $this->workspace->id]);
+    $this->workspace->members()->attach($this->user->id, ['role' => Role::Member->value]);
+});
+
+test('connect redirects to the google-business oauth driver', function () {
+    $driverMock = Mockery::mock();
+    $driverMock->shouldReceive('scopes')->andReturnSelf();
+    $driverMock->shouldReceive('with')->andReturnSelf();
+    $driverMock->shouldReceive('redirect')->andReturn(Mockery::mock([
+        'getTargetUrl' => 'https://accounts.google.com/o/oauth2/auth?test=1',
+    ]));
+
+    Socialite::shouldReceive('driver')->with('google-business')->andReturn($driverMock);
+
+    $response = $this->actingAs($this->user)
+        ->withHeader('X-Inertia', 'true')
+        ->get(route('app.social.google-business.connect'));
+
+    $response->assertStatus(409); // Inertia::location returns 409 with X-Inertia header
+
+    expect(session('social_connect_workspace'))->toBe($this->workspace->id);
+});
+
+test('google business callback auto-connects when exactly one location exists', function () {
+    session(['social_connect_workspace' => $this->workspace->id]);
+
+    $socialiteUser = Mockery::mock(SocialiteUser::class);
+    $socialiteUser->shouldReceive('getId')->andReturn('gid-1');
+    $socialiteUser->token = 'access-token';
+    $socialiteUser->refreshToken = 'refresh-token';
+    $socialiteUser->expiresIn = 3600;
+
+    Socialite::shouldReceive('driver')->with('google-business')->andReturn(
+        Mockery::mock()->shouldReceive('user')->andReturn($socialiteUser)->getMock()
+    );
+
+    $this->mock(GoogleBusinessPublisher::class, function ($mock) {
+        $mock->shouldReceive('fetchLocations')->once()->with('access-token')->andReturn([
+            ['id' => 'accounts/1/locations/2', 'account_name' => 'accounts/1', 'location_name' => 'locations/2', 'title' => 'Downtown Store', 'address' => null],
+        ]);
+    });
+
+    $response = $this->actingAs($this->user)->get(route('app.social.google-business.callback'));
+
+    $response->assertOk();
+    $response->assertInertia(fn (AssertableInertia $page) => $page
+        ->component('accounts/PopupCallback')
+        ->where('success', true)
+    );
+
+    $this->assertDatabaseHas('social_accounts', [
+        'workspace_id' => $this->workspace->id,
+        'platform' => Platform::GoogleBusiness->value,
+        'platform_user_id' => 'accounts/1/locations/2',
+        'display_name' => 'Downtown Store',
+        'status' => Status::Connected->value,
+    ]);
+
+    $account = $this->workspace->socialAccounts()->where('platform', Platform::GoogleBusiness)->first();
+    expect($account->meta['location_id'])->toBe('accounts/1/locations/2')
+        ->and($account->meta['account_name'])->toBe('accounts/1')
+        ->and($account->meta['google_user_id'])->toBe('gid-1');
+});
+
+test('google business callback shows the location picker when multiple locations exist', function () {
+    session(['social_connect_workspace' => $this->workspace->id]);
+
+    $socialiteUser = Mockery::mock(SocialiteUser::class);
+    $socialiteUser->shouldReceive('getId')->andReturn('gid-1');
+    $socialiteUser->token = 'access-token';
+    $socialiteUser->refreshToken = 'refresh-token';
+    $socialiteUser->expiresIn = 3600;
+
+    Socialite::shouldReceive('driver')->with('google-business')->andReturn(
+        Mockery::mock()->shouldReceive('user')->andReturn($socialiteUser)->getMock()
+    );
+
+    $this->mock(GoogleBusinessPublisher::class, function ($mock) {
+        $mock->shouldReceive('fetchLocations')->once()->andReturn([
+            ['id' => 'accounts/1/locations/2', 'account_name' => 'accounts/1', 'location_name' => 'locations/2', 'title' => 'Downtown Store', 'address' => null],
+            ['id' => 'accounts/1/locations/3', 'account_name' => 'accounts/1', 'location_name' => 'locations/3', 'title' => 'Uptown Store', 'address' => null],
+        ]);
+    });
+
+    $response = $this->actingAs($this->user)->get(route('app.social.google-business.callback'));
+
+    $response->assertRedirect(route('app.social.google-business.select-location'));
+
+    expect($this->workspace->socialAccounts()->where('platform', Platform::GoogleBusiness)->exists())->toBeFalse();
+    expect(session('google_business_oauth'))->not->toBeNull();
+    expect(data_get(session('google_business_oauth'), 'access_token'))->toBe('access-token');
+});
+
+test('google business callback fails when no locations are found', function () {
+    session(['social_connect_workspace' => $this->workspace->id]);
+
+    $socialiteUser = Mockery::mock(SocialiteUser::class);
+    $socialiteUser->shouldReceive('getId')->andReturn('gid-1');
+    $socialiteUser->token = 'access-token';
+    $socialiteUser->refreshToken = 'refresh-token';
+    $socialiteUser->expiresIn = 3600;
+
+    Socialite::shouldReceive('driver')->with('google-business')->andReturn(
+        Mockery::mock()->shouldReceive('user')->andReturn($socialiteUser)->getMock()
+    );
+
+    $this->mock(GoogleBusinessPublisher::class, function ($mock) {
+        $mock->shouldReceive('fetchLocations')->once()->andReturn([]);
+    });
+
+    $response = $this->actingAs($this->user)->get(route('app.social.google-business.callback'));
+
+    $response->assertOk();
+    $response->assertInertia(fn (AssertableInertia $page) => $page
+        ->where('success', false)
+        ->where('message', __('accounts.popup_callback.no_google_business_locations'))
+    );
+
+    expect($this->workspace->socialAccounts()->where('platform', Platform::GoogleBusiness)->exists())->toBeFalse();
+});
+
+test('google business callback shows network_taken when the network is already connected', function () {
+    config()->set('trypost.self_hosted', false);
+
+    SocialAccount::factory()->create([
+        'workspace_id' => $this->workspace->id,
+        'platform' => Platform::GoogleBusiness,
+        'platform_user_id' => 'accounts/9/locations/9',
+    ]);
+
+    session(['social_connect_workspace' => $this->workspace->id]);
+
+    $socialiteUser = Mockery::mock(SocialiteUser::class);
+    $socialiteUser->shouldReceive('getId')->andReturn('gid-1');
+    $socialiteUser->token = 'access-token';
+    $socialiteUser->refreshToken = 'refresh-token';
+    $socialiteUser->expiresIn = 3600;
+
+    Socialite::shouldReceive('driver')->with('google-business')->andReturn(
+        Mockery::mock()->shouldReceive('user')->andReturn($socialiteUser)->getMock()
+    );
+
+    $this->mock(GoogleBusinessPublisher::class, function ($mock) {
+        $mock->shouldReceive('fetchLocations')->once()->andReturn([
+            ['id' => 'accounts/1/locations/2', 'account_name' => 'accounts/1', 'location_name' => 'locations/2', 'title' => 'Downtown Store', 'address' => null],
+        ]);
+    });
+
+    $response = $this->actingAs($this->user)->get(route('app.social.google-business.callback'));
+
+    $response->assertOk();
+    $response->assertInertia(fn (AssertableInertia $page) => $page
+        ->where('success', false)
+        ->where('message', __('accounts.popup_callback.network_taken'))
+    );
+
+    expect($this->workspace->socialAccounts()->where('platform', Platform::GoogleBusiness)->count())->toBe(1);
+});
+
+test('google business callback fails with expired session', function () {
+    // No session data - simulating expired session
+
+    $response = $this->actingAs($this->user)->get(route('app.social.google-business.callback'));
+
+    $response->assertOk();
+    $response->assertInertia(fn (AssertableInertia $page) => $page
+        ->where('success', false)
+        ->where('message', __('accounts.popup_callback.session_expired'))
+    );
+});
+
+test('select creates the social account for the chosen location', function () {
+    session([
+        'social_connect_workspace' => $this->workspace->id,
+        'google_business_oauth' => [
+            'access_token' => 'access-token',
+            'refresh_token' => 'refresh-token',
+            'expires_in' => 3600,
+            'user_id' => 'gid-1',
+        ],
+    ]);
+
+    $this->mock(GoogleBusinessPublisher::class, function ($mock) {
+        $mock->shouldReceive('fetchLocations')->once()->with('access-token')->andReturn([
+            ['id' => 'accounts/1/locations/2', 'account_name' => 'accounts/1', 'location_name' => 'locations/2', 'title' => 'Downtown Store', 'address' => null],
+            ['id' => 'accounts/1/locations/3', 'account_name' => 'accounts/1', 'location_name' => 'locations/3', 'title' => 'Uptown Store', 'address' => null],
+        ]);
+    });
+
+    $response = $this->actingAs($this->user)
+        ->post(route('app.social.google-business.select'), ['location_id' => 'accounts/1/locations/2']);
+
+    $response->assertOk();
+    $response->assertInertia(fn (AssertableInertia $page) => $page
+        ->component('accounts/PopupCallback')
+        ->where('success', true)
+    );
+
+    $account = $this->workspace->socialAccounts()->where('platform', Platform::GoogleBusiness)->first();
+    expect($account)->not->toBeNull()
+        ->and($account->meta['location_id'])->toBe('accounts/1/locations/2')
+        ->and($account->status)->toBe(Status::Connected)
+        ->and(session('google_business_oauth'))->toBeNull();
+});
+
+test('select fails with an unknown location id', function () {
+    session([
+        'social_connect_workspace' => $this->workspace->id,
+        'google_business_oauth' => [
+            'access_token' => 'access-token',
+            'refresh_token' => 'refresh-token',
+            'expires_in' => 3600,
+            'user_id' => 'gid-1',
+        ],
+    ]);
+
+    $this->mock(GoogleBusinessPublisher::class, function ($mock) {
+        $mock->shouldReceive('fetchLocations')->once()->andReturn([
+            ['id' => 'accounts/1/locations/2', 'account_name' => 'accounts/1', 'location_name' => 'locations/2', 'title' => 'Downtown Store', 'address' => null],
+        ]);
+    });
+
+    $response = $this->actingAs($this->user)
+        ->post(route('app.social.google-business.select'), ['location_id' => 'accounts/1/locations/nope']);
+
+    $response->assertOk();
+    $response->assertInertia(fn (AssertableInertia $page) => $page
+        ->where('success', false)
+        ->where('message', __('accounts.popup_callback.location_not_found'))
+    );
+
+    expect($this->workspace->socialAccounts()->where('platform', Platform::GoogleBusiness)->exists())->toBeFalse();
+});
+
+test('select fails with expired session', function () {
+    // No session data
+
+    $response = $this->actingAs($this->user)
+        ->post(route('app.social.google-business.select'), ['location_id' => 'accounts/1/locations/2']);
+
+    $response->assertOk();
+    $response->assertInertia(fn (AssertableInertia $page) => $page
+        ->where('success', false)
+        ->where('message', __('accounts.popup_callback.session_expired'))
+    );
+});
+
+test('select reconnects an existing account when a reconnect id is present', function () {
+    $existingAccount = SocialAccount::factory()->create([
+        'workspace_id' => $this->workspace->id,
+        'platform' => Platform::GoogleBusiness,
+        'platform_user_id' => 'accounts/1/locations/2',
+        'status' => Status::TokenExpired,
+    ]);
+
+    session([
+        'social_connect_workspace' => $this->workspace->id,
+        'google_business_oauth' => [
+            'access_token' => 'new-access-token',
+            'refresh_token' => 'new-refresh-token',
+            'expires_in' => 3600,
+            'user_id' => 'gid-1',
+            'reconnect_id' => $existingAccount->id,
+        ],
+    ]);
+
+    $this->mock(GoogleBusinessPublisher::class, function ($mock) {
+        $mock->shouldReceive('fetchLocations')->once()->with('new-access-token')->andReturn([
+            ['id' => 'accounts/1/locations/2', 'account_name' => 'accounts/1', 'location_name' => 'locations/2', 'title' => 'Downtown Store', 'address' => null],
+        ]);
+    });
+
+    $response = $this->actingAs($this->user)
+        ->post(route('app.social.google-business.select'), ['location_id' => 'accounts/1/locations/2']);
+
+    $response->assertOk();
+    $response->assertInertia(fn (AssertableInertia $page) => $page
+        ->where('success', true)
+        ->where('message', __('accounts.popup_callback.reconnected'))
+    );
+
+    expect($this->workspace->socialAccounts()->where('platform', Platform::GoogleBusiness)->count())->toBe(1);
+
+    $existingAccount->refresh();
+    expect($existingAccount->status)->toBe(Status::Connected)
+        ->and($existingAccount->access_token)->toBe('new-access-token');
+});

From a37b280d57580f82cb814ffb3ef5bdaef1fa2a12 Mon Sep 17 00:00:00 2001
From: Paulo Castellano <paulo@castellanos.llc>
Date: Mon, 10 Aug 2026 23:56:46 -0300
Subject: [PATCH 12/47] feat: add Google Business Profile location picker page

---
 .../accounts/GoogleBusinessLocationSelect.vue | 86 +++++++++++++++++++
 1 file changed, 86 insertions(+)
 create mode 100644 resources/js/pages/accounts/GoogleBusinessLocationSelect.vue

diff --git a/resources/js/pages/accounts/GoogleBusinessLocationSelect.vue b/resources/js/pages/accounts/GoogleBusinessLocationSelect.vue
new file mode 100644
index 000000000..f2e383ee2
--- /dev/null
+++ b/resources/js/pages/accounts/GoogleBusinessLocationSelect.vue
@@ -0,0 +1,86 @@
+<script setup lang="ts">
+import { useForm } from '@inertiajs/vue3';
+import { IconBuildingStore } from '@tabler/icons-vue';
+
+import { Avatar, AvatarFallback } from '@/components/ui/avatar';
+import { Button } from '@/components/ui/button';
+import PopupLayout from '@/layouts/PopupLayout.vue';
+import { select as selectGoogleBusinessLocation } from '@/routes/app/social/google-business';
+
+interface Location {
+    id: string;
+    account_name: string;
+    location_name: string;
+    title: string;
+    address: string | null;
+}
+
+interface Workspace {
+    id: string;
+    name: string;
+}
+
+interface Props {
+    workspace: Workspace;
+    locations: Location[];
+}
+
+defineProps<Props>();
+
+const form = useForm({ location_id: '' });
+
+const handleSelectLocation = (location: Location) => {
+    form.location_id = location.id;
+    form.post(selectGoogleBusinessLocation.url());
+};
+</script>
+
+<template>
+    <PopupLayout :title="$t('accounts.google_business.title')">
+        <div class="flex flex-col gap-6">
+            <div class="flex items-center gap-3">
+                <img src="/images/accounts/google_business.png" alt="Google Business Profile" class="h-10 w-10" />
+                <div>
+                    <h1 class="text-xl font-bold tracking-tight">{{ $t('accounts.google_business.title') }}</h1>
+                    <p class="text-sm text-muted-foreground">{{ $t('accounts.google_business.description') }}</p>
+                </div>
+            </div>
+
+            <div v-if="locations.length === 0" class="py-12 text-center">
+                <div class="mx-auto flex h-14 w-14 items-center justify-center rounded-full bg-muted">
+                    <IconBuildingStore class="h-7 w-7 text-muted-foreground" />
+                </div>
+                <h3 class="mt-4 text-lg font-semibold">{{ $t('accounts.google_business.no_locations') }}</h3>
+                <p class="mt-1 text-sm text-muted-foreground">
+                    {{ $t('accounts.google_business.no_locations_description') }}
+                </p>
+            </div>
+
+            <div v-else class="grid gap-3">
+                <div
+                    v-for="location in locations"
+                    :key="location.id"
+                    class="flex items-center gap-4 rounded-lg border bg-card p-4"
+                    dusk="google-business-location"
+                >
+                    <Avatar class="h-12 w-12 shrink-0 rounded-lg">
+                        <AvatarFallback class="rounded-lg bg-blue-100 dark:bg-blue-900">
+                            <IconBuildingStore class="h-6 w-6 text-blue-600 dark:text-blue-400" />
+                        </AvatarFallback>
+                    </Avatar>
+                    <div class="min-w-0 flex-1">
+                        <h3 class="truncate font-semibold">{{ location.title }}</h3>
+                        <p v-if="location.address" class="truncate text-sm text-muted-foreground">
+                            {{ location.address }}
+                        </p>
+                    </div>
+                    <div class="flex shrink-0 items-center gap-2">
+                        <Button size="sm" dusk="choose-google-business-location" :disabled="form.processing" @click="handleSelectLocation(location)">
+                            {{ $t('accounts.google_business.choose') }}
+                        </Button>
+                    </div>
+                </div>
+            </div>
+        </div>
+    </PopupLayout>
+</template>

From 4c3709e0f1b0ec545489f8b281846b5b2c2a06d1 Mon Sep 17 00:00:00 2001
From: Paulo Castellano <paulo@castellanos.llc>
Date: Tue, 11 Aug 2026 00:01:59 -0300
Subject: [PATCH 13/47] feat: add Google Business Profile composer settings
 card

---
 public/images/accounts/google_business.png    | Bin 0 -> 479 bytes
 .../posts/editor/GoogleBusinessSettings.vue   | 222 ++++++++++++++++++
 resources/js/composables/usePlatformLogo.ts   |   3 +
 3 files changed, 225 insertions(+)
 create mode 100644 public/images/accounts/google_business.png
 create mode 100644 resources/js/components/posts/editor/GoogleBusinessSettings.vue

diff --git a/public/images/accounts/google_business.png b/public/images/accounts/google_business.png
new file mode 100644
index 0000000000000000000000000000000000000000..0b45bc84e80108d2e0350bb1974f746a1a7767a5
GIT binary patch
literal 479
zcmV<50U-W~P)<h;3K|Lk000e1NJLTq001%o001%w1^@s69zTe&00009a7bBm000ie
z000ie0hKEb8vp<Skx4{BRA_<inmrN%Aq+;dj-8%LZ>6=~N>8P=Hbyam1oA~###ipF
zkw?NTe?)^Yc?8`YF1Oq}=lvS`->_hs#-~6?nF3fEpQ2W(TEs(wsgWuEfv13^M5svQ
zmlBLtMlI4pg3-vRL|RHPIhm|T4-(8bnXe)}NiZpyqzFRdv|D{V+a9mhuu++)h*csc
zAh8NbnWZV3KqDaEMP!I5l9AeMlt@TwWx}kyiL{VltTNEjiV-#tA)I1i4UlTw_IUm1
z<=C@a94$`~<ToQ%Ca3{U^lG;$Bj{4G#50$cMBCfQtPnj!dYp=susK|A@QkzqE~2e-
z^!PG~pzGWc&!x0-z3uT~oQQm9yV@_iHM{Op6whf%2&A;Ey@?oWurX5G82EYw`BD7E
z3NhroUr#P$gd6F#W{=@I*u5GZ1F}MF39k_UbFJQh?V_|Gxr@TgK}K%Sjaynw&skCL
z{W3ku6z|3}J;_v`k1##Rm`|*jA<ht)Ax?FfA<o%DW`FY`WQe;cl3CvlO3~uJ)*bK{
V$YpjyLs9?$002ovPDHLkV1gk;(w_hT

literal 0
HcmV?d00001

diff --git a/resources/js/components/posts/editor/GoogleBusinessSettings.vue b/resources/js/components/posts/editor/GoogleBusinessSettings.vue
new file mode 100644
index 000000000..1611d6b27
--- /dev/null
+++ b/resources/js/components/posts/editor/GoogleBusinessSettings.vue
@@ -0,0 +1,222 @@
+<script setup lang="ts">
+import { IconChevronDown, IconChevronUp } from '@tabler/icons-vue';
+import { computed, ref } from 'vue';
+
+import InputError from '@/components/InputError.vue';
+import { Avatar } from '@/components/ui/avatar';
+import { Input } from '@/components/ui/input';
+import { Textarea } from '@/components/ui/textarea';
+import { usePageErrors } from '@/composables/usePageErrors';
+import { getPlatformLogo } from '@/composables/usePlatformLogo';
+
+interface SocialAccount {
+    id: string;
+    platform: string;
+    display_name: string;
+    username: string;
+    display_label: string;
+    avatar_url: string | null;
+}
+
+interface Props {
+    socialAccount: SocialAccount | null;
+    meta: Record<string, any>;
+    disabled?: boolean;
+    previewOnly?: boolean;
+}
+
+const props = withDefaults(defineProps<Props>(), {
+    disabled: false,
+    previewOnly: false,
+});
+
+const emit = defineEmits<{
+    'update:meta': [value: Record<string, any>];
+}>();
+
+const open = ref(false);
+
+const topicTypes = [
+    { value: 'STANDARD', labelKey: 'posts.form.google_business.topic_type.standard' },
+    { value: 'EVENT', labelKey: 'posts.form.google_business.topic_type.event' },
+    { value: 'OFFER', labelKey: 'posts.form.google_business.topic_type.offer' },
+] as const;
+
+const ctaOptions = [
+    { value: 'NONE', labelKey: 'posts.form.google_business.cta_none' },
+    { value: 'BOOK', labelKey: 'posts.form.google_business.cta.book' },
+    { value: 'ORDER', labelKey: 'posts.form.google_business.cta.order' },
+    { value: 'SHOP', labelKey: 'posts.form.google_business.cta.shop' },
+    { value: 'LEARN_MORE', labelKey: 'posts.form.google_business.cta.learn_more' },
+    { value: 'SIGN_UP', labelKey: 'posts.form.google_business.cta.sign_up' },
+    { value: 'GET_OFFER', labelKey: 'posts.form.google_business.cta.get_offer' },
+    { value: 'CALL', labelKey: 'posts.form.google_business.cta.call' },
+] as const;
+
+const topicType = computed<string>({
+    get: () => props.meta?.topic_type || 'STANDARD',
+    set: (value: string) => emit('update:meta', { ...props.meta, topic_type: value }),
+});
+
+const ctaActionType = computed<string>({
+    get: () => props.meta?.call_to_action?.action_type || 'NONE',
+    set: (value: string) => emit('update:meta', {
+        ...props.meta,
+        call_to_action: { ...props.meta?.call_to_action, action_type: value },
+    }),
+});
+
+const showCtaUrl = computed(() => ctaActionType.value !== 'NONE' && ctaActionType.value !== 'CALL');
+
+const ctaUrl = computed<string>({
+    get: () => props.meta?.call_to_action?.url || '',
+    set: (value: string) => emit('update:meta', {
+        ...props.meta,
+        call_to_action: { ...props.meta?.call_to_action, url: value.trim() === '' ? null : value },
+    }),
+});
+
+const eventField = (key: 'title' | 'start_date' | 'end_date' | 'start_time' | 'end_time') => computed<string>({
+    get: () => props.meta?.event?.[key] || '',
+    set: (value: string) => emit('update:meta', {
+        ...props.meta,
+        event: { ...props.meta?.event, [key]: value.trim() === '' ? null : value },
+    }),
+});
+
+const eventTitle = eventField('title');
+const eventStartDate = eventField('start_date');
+const eventEndDate = eventField('end_date');
+const eventStartTime = eventField('start_time');
+const eventEndTime = eventField('end_time');
+
+const offerField = (key: 'coupon_code' | 'redeem_online_url' | 'terms_conditions') => computed<string>({
+    get: () => props.meta?.offer?.[key] || '',
+    set: (value: string) => emit('update:meta', {
+        ...props.meta,
+        offer: { ...props.meta?.offer, [key]: value.trim() === '' ? null : value },
+    }),
+});
+
+const offerCouponCode = offerField('coupon_code');
+const offerRedeemUrl = offerField('redeem_online_url');
+const offerTerms = offerField('terms_conditions');
+
+// Surface backend validation errors keyed by platform index
+// (`platforms.0.meta.*`). Suffix match avoids threading the index through props.
+const errors = usePageErrors();
+const findError = (suffix: string) => computed<string | undefined>(
+    () => Object.entries(errors.value).find(([key]) => key.endsWith(suffix))?.[1],
+);
+const eventTitleError = findError('.meta.event.title');
+const eventStartDateError = findError('.meta.event.start_date');
+const eventEndDateError = findError('.meta.event.end_date');
+const ctaUrlError = findError('.meta.call_to_action.url');
+</script>
+
+<template>
+    <div class="rounded-xl border-2 border-foreground bg-card shadow-2xs">
+        <button
+            type="button"
+            class="flex w-full cursor-pointer items-center justify-between gap-3 p-4 text-sm"
+            @click="open = !open"
+        >
+            <span class="flex min-w-0 items-center gap-2">
+                <span class="inline-flex size-6 shrink-0 items-center justify-center overflow-hidden rounded-full border-2 border-foreground bg-card shadow-2xs">
+                    <img :src="getPlatformLogo('google_business')" alt="Google Business Profile" class="size-full object-cover" />
+                </span>
+                <span class="truncate font-bold text-foreground">{{ $t('posts.form.google_business.settings') }}</span>
+                <span v-if="socialAccount?.display_label" class="truncate font-medium text-foreground/60">·&nbsp;{{ socialAccount.display_label }}</span>
+            </span>
+            <IconChevronUp v-if="open" class="size-4 shrink-0 text-foreground/60" />
+            <IconChevronDown v-else class="size-4 shrink-0 text-foreground/60" />
+        </button>
+
+        <div v-if="open" class="space-y-5 border-t-2 border-foreground/10 px-4 pb-4 pt-4">
+            <div v-if="socialAccount" class="flex items-center gap-3 rounded-lg bg-foreground/5 p-3">
+                <Avatar :src="socialAccount.avatar_url" :name="socialAccount.display_label" class="size-9 shrink-0 rounded-full border-2 border-foreground shadow-2xs" />
+                <div class="min-w-0 flex-1">
+                    <p class="text-[11px] font-black uppercase tracking-widest text-foreground/60">{{ $t('posts.form.google_business.posting_to') }}</p>
+                    <p class="truncate text-sm font-bold text-foreground">{{ socialAccount.display_label }}</p>
+                </div>
+            </div>
+
+            <div class="space-y-2">
+                <p class="text-[11px] font-black uppercase tracking-widest text-foreground/60">{{ $t('posts.form.google_business.topic_type_label') }}</p>
+                <div class="flex flex-wrap gap-2">
+                    <button
+                        v-for="type in topicTypes"
+                        :key="type.value"
+                        type="button"
+                        class="cursor-pointer rounded-full border-2 px-3 py-1 text-xs font-bold uppercase tracking-widest transition-colors disabled:cursor-not-allowed disabled:opacity-50"
+                        :class="topicType === type.value
+                            ? 'border-foreground bg-violet-100 text-foreground shadow-2xs'
+                            : 'border-foreground/30 text-foreground/70 hover:border-foreground hover:text-foreground'"
+                        :disabled="disabled"
+                        @click="topicType = type.value"
+                    >
+                        {{ $t(type.labelKey) }}
+                    </button>
+                </div>
+            </div>
+
+            <div v-if="topicType === 'EVENT'" class="grid grid-cols-2 gap-3">
+                <div class="col-span-2 space-y-2">
+                    <p class="text-[11px] font-black uppercase tracking-widest text-foreground/60">{{ $t('posts.form.google_business.event_title') }}</p>
+                    <Input v-model="eventTitle" type="text" :placeholder="$t('posts.form.google_business.event_title_placeholder')" :disabled="disabled || previewOnly" :class="eventTitleError ? 'border-rose-500' : undefined" />
+                    <InputError :message="eventTitleError" />
+                </div>
+                <div class="space-y-2">
+                    <p class="text-[11px] font-black uppercase tracking-widest text-foreground/60">{{ $t('posts.form.google_business.event_start_date') }}</p>
+                    <Input v-model="eventStartDate" type="date" :disabled="disabled || previewOnly" :class="eventStartDateError ? 'border-rose-500' : undefined" />
+                    <InputError :message="eventStartDateError" />
+                </div>
+                <div class="space-y-2">
+                    <p class="text-[11px] font-black uppercase tracking-widest text-foreground/60">{{ $t('posts.form.google_business.event_end_date') }}</p>
+                    <Input v-model="eventEndDate" type="date" :disabled="disabled || previewOnly" :class="eventEndDateError ? 'border-rose-500' : undefined" />
+                    <InputError :message="eventEndDateError" />
+                </div>
+                <div class="space-y-2">
+                    <p class="text-[11px] font-black uppercase tracking-widest text-foreground/60">{{ $t('posts.form.google_business.event_start_time') }}</p>
+                    <Input v-model="eventStartTime" type="time" :disabled="disabled || previewOnly" />
+                </div>
+                <div class="space-y-2">
+                    <p class="text-[11px] font-black uppercase tracking-widest text-foreground/60">{{ $t('posts.form.google_business.event_end_time') }}</p>
+                    <Input v-model="eventEndTime" type="time" :disabled="disabled || previewOnly" />
+                </div>
+            </div>
+
+            <div v-if="topicType === 'OFFER'" class="space-y-3">
+                <div class="space-y-2">
+                    <p class="text-[11px] font-black uppercase tracking-widest text-foreground/60">{{ $t('posts.form.google_business.offer_coupon_code') }}</p>
+                    <Input v-model="offerCouponCode" type="text" :disabled="disabled || previewOnly" />
+                </div>
+                <div class="space-y-2">
+                    <p class="text-[11px] font-black uppercase tracking-widest text-foreground/60">{{ $t('posts.form.google_business.offer_redeem_url') }}</p>
+                    <Input v-model="offerRedeemUrl" type="text" :disabled="disabled || previewOnly" />
+                </div>
+                <div class="space-y-2">
+                    <p class="text-[11px] font-black uppercase tracking-widest text-foreground/60">{{ $t('posts.form.google_business.offer_terms') }}</p>
+                    <Textarea v-model="offerTerms" :disabled="disabled || previewOnly" rows="2" />
+                </div>
+            </div>
+
+            <div class="space-y-2">
+                <p class="text-[11px] font-black uppercase tracking-widest text-foreground/60">{{ $t('posts.form.google_business.cta_label') }}</p>
+                <select
+                    v-model="ctaActionType"
+                    class="w-full rounded-lg border-2 border-foreground/30 bg-card px-3 py-2 text-sm font-medium text-foreground disabled:cursor-not-allowed disabled:opacity-50"
+                    :disabled="disabled || previewOnly"
+                >
+                    <option v-for="option in ctaOptions" :key="option.value" :value="option.value">{{ $t(option.labelKey) }}</option>
+                </select>
+            </div>
+
+            <div v-if="showCtaUrl" class="space-y-2">
+                <p class="text-[11px] font-black uppercase tracking-widest text-foreground/60">{{ $t('posts.form.google_business.cta_url') }}</p>
+                <Input v-model="ctaUrl" type="text" :placeholder="$t('posts.form.google_business.cta_url_placeholder')" :disabled="disabled || previewOnly" :class="ctaUrlError ? 'border-rose-500' : undefined" />
+                <InputError :message="ctaUrlError" />
+            </div>
+        </div>
+    </div>
+</template>
diff --git a/resources/js/composables/usePlatformLogo.ts b/resources/js/composables/usePlatformLogo.ts
index 4b0baf684..2c3e6923d 100644
--- a/resources/js/composables/usePlatformLogo.ts
+++ b/resources/js/composables/usePlatformLogo.ts
@@ -13,6 +13,7 @@ const PLATFORM_LOGOS: Record<string, string> = {
     mastodon: '/images/accounts/mastodon.png',
     telegram: '/images/accounts/telegram.png',
     discord: '/images/accounts/discord.png',
+    google_business: '/images/accounts/google_business.png',
 };
 
 const PLATFORM_LABELS: Record<string, string> = {
@@ -30,6 +31,7 @@ const PLATFORM_LABELS: Record<string, string> = {
     mastodon: 'Mastodon',
     telegram: 'Telegram',
     discord: 'Discord',
+    google_business: 'Google Business Profile',
 };
 
 const PLATFORM_CONTENT_TYPES: Record<string, string[]> = {
@@ -51,6 +53,7 @@ const PLATFORM_CONTENT_TYPES: Record<string, string[]> = {
     mastodon: ['mastodon_post'],
     telegram: ['telegram_post'],
     discord: ['discord_message'],
+    google_business: ['google_business_post'],
 };
 
 export interface ContentTypeOption {

From ea898904431eed2bc5dad7e018df5757eeb1f61f Mon Sep 17 00:00:00 2001
From: Paulo Castellano <paulo@castellanos.llc>
Date: Tue, 11 Aug 2026 00:03:48 -0300
Subject: [PATCH 14/47] fix: add ContentType.GoogleBusinessPost to frontend
 content-type enum

---
 resources/js/types/content-type.ts | 1 +
 1 file changed, 1 insertion(+)

diff --git a/resources/js/types/content-type.ts b/resources/js/types/content-type.ts
index 22462b699..43eea690a 100644
--- a/resources/js/types/content-type.ts
+++ b/resources/js/types/content-type.ts
@@ -19,6 +19,7 @@ export const ContentType = {
     MastodonPost: 'mastodon_post',
     TelegramPost: 'telegram_post',
     DiscordMessage: 'discord_message',
+    GoogleBusinessPost: 'google_business_post',
 } as const;
 
 export type ContentTypeValue = (typeof ContentType)[keyof typeof ContentType];

From 467cfb61359e7679d19a635ed579b13e437c45e5 Mon Sep 17 00:00:00 2001
From: Paulo Castellano <paulo@castellanos.llc>
Date: Tue, 11 Aug 2026 00:06:41 -0300
Subject: [PATCH 15/47] feat: wire Google Business Profile settings into the
 post composer

---
 resources/js/components/ChannelConfigurator.vue | 9 +++++++++
 1 file changed, 9 insertions(+)

diff --git a/resources/js/components/ChannelConfigurator.vue b/resources/js/components/ChannelConfigurator.vue
index ce3d00e87..6b58e98ed 100644
--- a/resources/js/components/ChannelConfigurator.vue
+++ b/resources/js/components/ChannelConfigurator.vue
@@ -4,6 +4,7 @@ import { computed } from 'vue';
 
 import DiscordSettings from '@/components/posts/editor/DiscordSettings.vue';
 import FacebookSettings from '@/components/posts/editor/FacebookSettings.vue';
+import GoogleBusinessSettings from '@/components/posts/editor/GoogleBusinessSettings.vue';
 import InstagramSettings from '@/components/posts/editor/InstagramSettings.vue';
 import LinkedInSettings from '@/components/posts/editor/LinkedInSettings.vue';
 import PinterestSettings from '@/components/posts/editor/PinterestSettings.vue';
@@ -178,6 +179,14 @@ const selectedChannels = computed(() => props.channels.filter((channel) => isSel
                 :preview-only="previewOnly"
                 @update:meta="emit('update:meta', channel.id, $event)"
             />
+            <GoogleBusinessSettings
+                v-else-if="channel.platform === Platform.GoogleBusiness"
+                :social-account="channel.socialAccount"
+                :meta="channel.meta"
+                :disabled="disabled"
+                :preview-only="previewOnly"
+                @update:meta="emit('update:meta', channel.id, $event)"
+            />
         </template>
     </div>
 </template>

From f18cfcaf0adcb50871c28c65be406cca9d03d5ec Mon Sep 17 00:00:00 2001
From: Paulo Castellano <paulo@castellanos.llc>
Date: Tue, 11 Aug 2026 00:09:24 -0300
Subject: [PATCH 16/47] feat: add Google Business Profile post preview

---
 .../posts/previews/GoogleBusinessPreview.vue  | 80 +++++++++++++++++++
 .../posts/previews/PlatformPreview.vue        |  3 +
 .../js/components/posts/previews/index.ts     |  1 +
 3 files changed, 84 insertions(+)
 create mode 100644 resources/js/components/posts/previews/GoogleBusinessPreview.vue

diff --git a/resources/js/components/posts/previews/GoogleBusinessPreview.vue b/resources/js/components/posts/previews/GoogleBusinessPreview.vue
new file mode 100644
index 000000000..df40a564f
--- /dev/null
+++ b/resources/js/components/posts/previews/GoogleBusinessPreview.vue
@@ -0,0 +1,80 @@
+<script setup lang="ts">
+import { computed } from 'vue';
+
+import { getInitials } from '@/composables/useInitials';
+import type { MediaItem } from '@/types/media';
+
+interface SocialAccount {
+    id: string;
+    platform: string;
+    display_name: string;
+    username: string;
+    display_label: string;
+    avatar_url: string | null;
+}
+
+interface Props {
+    socialAccount: SocialAccount;
+    content: string;
+    media: MediaItem[];
+    meta?: Record<string, any>;
+}
+
+const props = defineProps<Props>();
+
+const ctaLabel = computed(() => {
+    const type = props.meta?.call_to_action?.action_type;
+
+    if (!type || type === 'NONE') return null;
+
+    const labels: Record<string, string> = {
+        BOOK: 'Book',
+        ORDER: 'Order online',
+        SHOP: 'Buy',
+        LEARN_MORE: 'Learn more',
+        SIGN_UP: 'Sign up',
+        GET_OFFER: 'Redeem offer',
+        CALL: 'Call now',
+    };
+
+    return labels[type] ?? null;
+});
+</script>
+
+<template>
+    <div class="flex h-full w-full flex-col overflow-hidden bg-white dark:bg-[#202124]">
+        <div class="flex items-center gap-3 border-b border-black/10 px-4 py-3 dark:border-white/10">
+            <img
+                v-if="socialAccount.avatar_url"
+                :src="socialAccount.avatar_url"
+                :alt="socialAccount.display_label"
+                class="h-9 w-9 rounded-full object-cover"
+            />
+            <div v-else class="flex h-9 w-9 items-center justify-center rounded-full bg-[#4285F4] font-semibold text-white">
+                {{ getInitials(socialAccount.display_label) }}
+            </div>
+            <div class="min-w-0 flex-1">
+                <div class="truncate text-sm font-semibold text-[#202124] dark:text-white">{{ socialAccount.display_label }}</div>
+                <div class="text-xs text-[#5f6368] dark:text-[#9aa0a6]">Google Business Profile</div>
+            </div>
+        </div>
+
+        <div class="flex-1 overflow-y-auto">
+            <div v-if="media.length > 0" class="aspect-video w-full overflow-hidden bg-black/5">
+                <img :src="media[0].url" :alt="media[0].original_filename" class="h-full w-full object-cover" />
+            </div>
+
+            <div class="space-y-3 px-4 py-3">
+                <p v-if="content" class="whitespace-pre-wrap text-sm text-[#202124] dark:text-[#e8eaed]">{{ content }}</p>
+
+                <button
+                    v-if="ctaLabel"
+                    type="button"
+                    class="rounded-full bg-[#4285F4] px-4 py-1.5 text-xs font-semibold text-white"
+                >
+                    {{ ctaLabel }}
+                </button>
+            </div>
+        </div>
+    </div>
+</template>
diff --git a/resources/js/components/posts/previews/PlatformPreview.vue b/resources/js/components/posts/previews/PlatformPreview.vue
index baf6a15b3..0d2802e9a 100644
--- a/resources/js/components/posts/previews/PlatformPreview.vue
+++ b/resources/js/components/posts/previews/PlatformPreview.vue
@@ -7,6 +7,7 @@ import type { MediaItem } from '@/types/media';
 import BlueskyPreview from './BlueskyPreview.vue';
 import DiscordPreview from './DiscordPreview.vue';
 import FacebookPreview from './FacebookPreview.vue';
+import GoogleBusinessPreview from './GoogleBusinessPreview.vue';
 import InstagramPreview from './InstagramPreview.vue';
 import LinkedInPreview from './LinkedInPreview.vue';
 import MastodonPreview from './MastodonPreview.vue';
@@ -78,6 +79,8 @@ const previewComponent = computed(() => {
             return TelegramPreview;
         case 'discord':
             return DiscordPreview;
+        case 'google_business':
+            return GoogleBusinessPreview;
         default:
             return LinkedInPreview;
     }
diff --git a/resources/js/components/posts/previews/index.ts b/resources/js/components/posts/previews/index.ts
index f0695a85d..c8619f98e 100644
--- a/resources/js/components/posts/previews/index.ts
+++ b/resources/js/components/posts/previews/index.ts
@@ -8,3 +8,4 @@ export { default as TikTokPreview } from './TikTokPreview.vue';
 export { default as YouTubePreview } from './YouTubePreview.vue';
 export { default as PinterestPreview } from './PinterestPreview.vue';
 export { default as BlueskyPreview } from './BlueskyPreview.vue';
+export { default as GoogleBusinessPreview } from './GoogleBusinessPreview.vue';

From 8887b3f34f756473fe3bb60cbff4a056da7bf2d6 Mon Sep 17 00:00:00 2001
From: Paulo Castellano <paulo@castellanos.llc>
Date: Tue, 11 Aug 2026 00:23:13 -0300
Subject: [PATCH 17/47] fix: stop Google Business call_to_action.url rule
 blocking every platform's post update

platforms.*.meta.call_to_action.url used required_unless, an implicit Laravel
validation rule that still runs when the field (and its whole call_to_action
block) is absent. Since no other platform sends call_to_action at all, the
missing action_type was treated as "not NONE/CALL" and made the URL required
on every post update (Pinterest, Discord, TikTok, etc.) across web, the REST
API, and MCP.

Follow the existing board_id/channel_id pattern: keep the rules() entry
unconditional and enforce the CTA-required-unless-NONE/CALL check only in
requiredMetaViolation(), scoped to Platform::GoogleBusiness. Adds the
cta_url_required translation key (all 16 locales) and test coverage for both
the regression and the still-enforced Google Business requirement.
---
 app/Support/PostPlatformMetaRules.php    |  5 ++-
 lang/ar/posts.php                        |  1 +
 lang/de/posts.php                        |  1 +
 lang/el/posts.php                        |  1 +
 lang/en/posts.php                        |  1 +
 lang/es/posts.php                        |  1 +
 lang/fr/posts.php                        |  1 +
 lang/it/posts.php                        |  1 +
 lang/ja/posts.php                        |  1 +
 lang/ko/posts.php                        |  1 +
 lang/nl/posts.php                        |  1 +
 lang/pl/posts.php                        |  1 +
 lang/pt-BR/posts.php                     |  1 +
 lang/ru/posts.php                        |  1 +
 lang/tr/posts.php                        |  1 +
 lang/uk/posts.php                        |  1 +
 lang/zh/posts.php                        |  1 +
 tests/Unit/PostPlatformMetaRulesTest.php | 57 ++++++++++++++++++++++++
 18 files changed, 77 insertions(+), 1 deletion(-)

diff --git a/app/Support/PostPlatformMetaRules.php b/app/Support/PostPlatformMetaRules.php
index e43be4f23..9ede518e4 100644
--- a/app/Support/PostPlatformMetaRules.php
+++ b/app/Support/PostPlatformMetaRules.php
@@ -81,7 +81,7 @@ public static function rules(): array
             'platforms.*.meta.topic_type' => ['sometimes', 'nullable', 'string', Rule::in(['STANDARD', 'EVENT', 'OFFER'])],
             'platforms.*.meta.call_to_action' => ['sometimes', 'nullable', 'array'],
             'platforms.*.meta.call_to_action.action_type' => ['sometimes', 'nullable', 'string', Rule::in(['NONE', 'BOOK', 'ORDER', 'SHOP', 'LEARN_MORE', 'SIGN_UP', 'GET_OFFER', 'CALL'])],
-            'platforms.*.meta.call_to_action.url' => ['required_unless:platforms.*.meta.call_to_action.action_type,NONE,CALL', 'nullable', 'url:http,https', 'max:2048'],
+            'platforms.*.meta.call_to_action.url' => ['sometimes', 'nullable', 'url:http,https', 'max:2048'],
             'platforms.*.meta.event' => ['sometimes', 'nullable', 'array'],
             'platforms.*.meta.event.title' => ['sometimes', 'nullable', 'string', 'max:100'],
             'platforms.*.meta.event.start_date' => ['sometimes', 'nullable', 'date'],
@@ -193,6 +193,9 @@ private static function requiredMetaViolation(?Platform $platform, mixed $meta):
             $platform === Platform::GoogleBusiness
                 && data_get($meta, 'topic_type', 'STANDARD') === 'EVENT'
                 && blank(data_get($meta, 'event.end_date')) => ['event.end_date', trans('posts.form.google_business.event_end_date_required')],
+            $platform === Platform::GoogleBusiness
+                && ! in_array(data_get($meta, 'call_to_action.action_type', 'NONE'), ['NONE', 'CALL'], true)
+                && blank(data_get($meta, 'call_to_action.url')) => ['call_to_action.url', trans('posts.form.google_business.cta_url_required')],
             default => null,
         };
     }
diff --git a/lang/ar/posts.php b/lang/ar/posts.php
index 10d84dcec..80609ca27 100644
--- a/lang/ar/posts.php
+++ b/lang/ar/posts.php
@@ -208,6 +208,7 @@
             ],
             'cta_url' => 'رابط الزر',
             'cta_url_placeholder' => 'https://example.com',
+            'cta_url_required' => 'أدخل رابطًا لهذا الزر، أو اختر "بدون زر".',
             'event_title' => 'عنوان الحدث',
             'event_title_placeholder' => 'عرض الصيف',
             'event_title_required' => 'أدخل عنوان الحدث.',
diff --git a/lang/de/posts.php b/lang/de/posts.php
index 4b2cd36f0..440b8c083 100644
--- a/lang/de/posts.php
+++ b/lang/de/posts.php
@@ -210,6 +210,7 @@
             ],
             'cta_url' => 'Schaltflächenlink',
             'cta_url_placeholder' => 'https://example.com',
+            'cta_url_required' => 'Gib einen Link für diese Schaltfläche ein oder wähle "Keine Schaltfläche".',
             'event_title' => 'Veranstaltungstitel',
             'event_title_placeholder' => 'Sommerverkauf',
             'event_title_required' => 'Gib einen Veranstaltungstitel ein.',
diff --git a/lang/el/posts.php b/lang/el/posts.php
index 33de913ab..c86b79983 100644
--- a/lang/el/posts.php
+++ b/lang/el/posts.php
@@ -208,6 +208,7 @@
             ],
             'cta_url' => 'Σύνδεσμος κουμπιού',
             'cta_url_placeholder' => 'https://example.com',
+            'cta_url_required' => 'Εισάγετε έναν σύνδεσμο για αυτό το κουμπί ή επιλέξτε "Χωρίς κουμπί".',
             'event_title' => 'Τίτλος εκδήλωσης',
             'event_title_placeholder' => 'Θερινή έκπτωση',
             'event_title_required' => 'Εισάγετε τίτλο εκδήλωσης.',
diff --git a/lang/en/posts.php b/lang/en/posts.php
index a8ca58a7f..301a703bc 100644
--- a/lang/en/posts.php
+++ b/lang/en/posts.php
@@ -208,6 +208,7 @@
             ],
             'cta_url' => 'Button link',
             'cta_url_placeholder' => 'https://example.com',
+            'cta_url_required' => 'Enter a link for this button, or choose "No button".',
             'event_title' => 'Event title',
             'event_title_placeholder' => 'Summer sale',
             'event_title_required' => 'Enter an event title.',
diff --git a/lang/es/posts.php b/lang/es/posts.php
index 1eb0e3d05..4e8826265 100644
--- a/lang/es/posts.php
+++ b/lang/es/posts.php
@@ -208,6 +208,7 @@
             ],
             'cta_url' => 'Enlace del botón',
             'cta_url_placeholder' => 'https://example.com',
+            'cta_url_required' => 'Ingresa un enlace para este botón, o elige "Sin botón".',
             'event_title' => 'Título del evento',
             'event_title_placeholder' => 'Venta de verano',
             'event_title_required' => 'Ingresa un título de evento.',
diff --git a/lang/fr/posts.php b/lang/fr/posts.php
index 6c276b900..055486276 100644
--- a/lang/fr/posts.php
+++ b/lang/fr/posts.php
@@ -208,6 +208,7 @@
             ],
             'cta_url' => 'Lien du bouton',
             'cta_url_placeholder' => 'https://example.com',
+            'cta_url_required' => 'Entrez un lien pour ce bouton, ou choisissez "Pas de bouton".',
             'event_title' => 'Titre de l\'événement',
             'event_title_placeholder' => 'Vente d\'été',
             'event_title_required' => 'Entrez un titre d\'événement.',
diff --git a/lang/it/posts.php b/lang/it/posts.php
index 0b4012afc..8bf1e46d8 100644
--- a/lang/it/posts.php
+++ b/lang/it/posts.php
@@ -208,6 +208,7 @@
             ],
             'cta_url' => 'Link del pulsante',
             'cta_url_placeholder' => 'https://example.com',
+            'cta_url_required' => 'Inserisci un link per questo pulsante, oppure scegli "Nessun pulsante".',
             'event_title' => 'Titolo evento',
             'event_title_placeholder' => 'Saldi estivi',
             'event_title_required' => 'Inserisci un titolo evento.',
diff --git a/lang/ja/posts.php b/lang/ja/posts.php
index 654191ee1..85e5980e7 100644
--- a/lang/ja/posts.php
+++ b/lang/ja/posts.php
@@ -208,6 +208,7 @@
             ],
             'cta_url' => 'ボタンリンク',
             'cta_url_placeholder' => 'https://example.com',
+            'cta_url_required' => 'このボタンのリンクを入力するか、「ボタンなし」を選択してください。',
             'event_title' => 'イベントタイトル',
             'event_title_placeholder' => '夏のセール',
             'event_title_required' => 'イベントタイトルを入力してください。',
diff --git a/lang/ko/posts.php b/lang/ko/posts.php
index d6648119e..c15a35841 100644
--- a/lang/ko/posts.php
+++ b/lang/ko/posts.php
@@ -208,6 +208,7 @@
             ],
             'cta_url' => '버튼 링크',
             'cta_url_placeholder' => 'https://example.com',
+            'cta_url_required' => '이 버튼의 링크를 입력하거나 "버튼 없음"을 선택하세요.',
             'event_title' => '이벤트 제목',
             'event_title_placeholder' => '여름 세일',
             'event_title_required' => '이벤트 제목을 입력하세요.',
diff --git a/lang/nl/posts.php b/lang/nl/posts.php
index 5fbd00266..57b3756a4 100644
--- a/lang/nl/posts.php
+++ b/lang/nl/posts.php
@@ -208,6 +208,7 @@
             ],
             'cta_url' => 'Koppelinformatie voor knop',
             'cta_url_placeholder' => 'https://example.com',
+            'cta_url_required' => 'Voer een link in voor deze knop, of kies "Geen knop".',
             'event_title' => 'Evenementtitel',
             'event_title_placeholder' => 'Zomeruitverkoop',
             'event_title_required' => 'Voer een evenementtitel in.',
diff --git a/lang/pl/posts.php b/lang/pl/posts.php
index c7736b9b0..9eb92b9e4 100644
--- a/lang/pl/posts.php
+++ b/lang/pl/posts.php
@@ -208,6 +208,7 @@
             ],
             'cta_url' => 'Link przycisku',
             'cta_url_placeholder' => 'https://example.com',
+            'cta_url_required' => 'Wpisz link dla tego przycisku lub wybierz "Bez przycisku".',
             'event_title' => 'Tytuł wydarzenia',
             'event_title_placeholder' => 'Letnia wyprzedaż',
             'event_title_required' => 'Wpisz tytuł wydarzenia.',
diff --git a/lang/pt-BR/posts.php b/lang/pt-BR/posts.php
index 8ffbc3a04..177a90fad 100644
--- a/lang/pt-BR/posts.php
+++ b/lang/pt-BR/posts.php
@@ -208,6 +208,7 @@
             ],
             'cta_url' => 'Link do botão',
             'cta_url_placeholder' => 'https://example.com',
+            'cta_url_required' => 'Insira um link para este botão, ou escolha "Sem botão".',
             'event_title' => 'Título do evento',
             'event_title_placeholder' => 'Venda de verão',
             'event_title_required' => 'Insira um título de evento.',
diff --git a/lang/ru/posts.php b/lang/ru/posts.php
index f7103b2be..8fc4737fd 100644
--- a/lang/ru/posts.php
+++ b/lang/ru/posts.php
@@ -208,6 +208,7 @@
             ],
             'cta_url' => 'Ссылка кнопки',
             'cta_url_placeholder' => 'https://example.com',
+            'cta_url_required' => 'Введите ссылку для этой кнопки или выберите "Без кнопки".',
             'event_title' => 'Название события',
             'event_title_placeholder' => 'Летняя распродажа',
             'event_title_required' => 'Введите название события.',
diff --git a/lang/tr/posts.php b/lang/tr/posts.php
index fa1c3f0b3..ed2e45d3d 100644
--- a/lang/tr/posts.php
+++ b/lang/tr/posts.php
@@ -210,6 +210,7 @@
             ],
             'cta_url' => 'Düğme bağlantısı',
             'cta_url_placeholder' => 'https://example.com',
+            'cta_url_required' => 'Bu düğme için bir bağlantı girin veya "Düğme yok" seçeneğini seçin.',
             'event_title' => 'Etkinlik başlığı',
             'event_title_placeholder' => 'Yaz indirimi',
             'event_title_required' => 'Bir etkinlik başlığı girin.',
diff --git a/lang/uk/posts.php b/lang/uk/posts.php
index a0727d89b..87cb236f6 100644
--- a/lang/uk/posts.php
+++ b/lang/uk/posts.php
@@ -208,6 +208,7 @@
             ],
             'cta_url' => 'Посилання кнопки',
             'cta_url_placeholder' => 'https://example.com',
+            'cta_url_required' => 'Введіть посилання для цієї кнопки або виберіть "Без кнопки".',
             'event_title' => 'Назва події',
             'event_title_placeholder' => 'Літній розпродаж',
             'event_title_required' => 'Введіть назву події.',
diff --git a/lang/zh/posts.php b/lang/zh/posts.php
index c3ca66317..2f4a8a711 100644
--- a/lang/zh/posts.php
+++ b/lang/zh/posts.php
@@ -208,6 +208,7 @@
             ],
             'cta_url' => '按钮链接',
             'cta_url_placeholder' => 'https://example.com',
+            'cta_url_required' => '请输入此按钮的链接，或选择"无按钮"。',
             'event_title' => '活动标题',
             'event_title_placeholder' => '夏季促销',
             'event_title_required' => '请输入活动标题。',
diff --git a/tests/Unit/PostPlatformMetaRulesTest.php b/tests/Unit/PostPlatformMetaRulesTest.php
index f3869f592..6ecd05bfe 100644
--- a/tests/Unit/PostPlatformMetaRulesTest.php
+++ b/tests/Unit/PostPlatformMetaRulesTest.php
@@ -70,3 +70,60 @@
     expect($rules)->toHaveKey('platforms.*.meta.event.title');
     expect($rules)->toHaveKey('platforms.*.meta.offer.coupon_code');
 });
+
+test('google business call_to_action.url rule is unconditional, not required_unless', function () {
+    $rules = PostPlatformMetaRules::rules();
+
+    expect($rules['platforms.*.meta.call_to_action.url'])->toBe(['sometimes', 'nullable', 'url:http,https', 'max:2048']);
+});
+
+test('google business call_to_action with a url-needing action type and no url requires a violation', function () {
+    $violation = (new ReflectionMethod(PostPlatformMetaRules::class, 'requiredMetaViolation'))
+        ->invoke(null, Platform::GoogleBusiness, [
+            'topic_type' => 'STANDARD',
+            'call_to_action' => ['action_type' => 'BOOK'],
+        ]);
+
+    expect($violation)->not->toBeNull();
+    expect($violation[0])->toBe('call_to_action.url');
+});
+
+test('google business call_to_action with action_type CALL has no url violation', function () {
+    $violation = (new ReflectionMethod(PostPlatformMetaRules::class, 'requiredMetaViolation'))
+        ->invoke(null, Platform::GoogleBusiness, [
+            'topic_type' => 'STANDARD',
+            'call_to_action' => ['action_type' => 'CALL'],
+        ]);
+
+    expect($violation)->toBeNull();
+});
+
+test('google business call_to_action with action_type NONE has no url violation', function () {
+    $violation = (new ReflectionMethod(PostPlatformMetaRules::class, 'requiredMetaViolation'))
+        ->invoke(null, Platform::GoogleBusiness, [
+            'topic_type' => 'STANDARD',
+            'call_to_action' => ['action_type' => 'NONE'],
+        ]);
+
+    expect($violation)->toBeNull();
+});
+
+test('google business call_to_action with url-needing action type and a url has no violation', function () {
+    $violation = (new ReflectionMethod(PostPlatformMetaRules::class, 'requiredMetaViolation'))
+        ->invoke(null, Platform::GoogleBusiness, [
+            'topic_type' => 'STANDARD',
+            'call_to_action' => ['action_type' => 'BOOK', 'url' => 'https://example.com/book'],
+        ]);
+
+    expect($violation)->toBeNull();
+});
+
+test('non google business platform is never checked against call_to_action requirements', function () {
+    $violation = (new ReflectionMethod(PostPlatformMetaRules::class, 'requiredMetaViolation'))
+        ->invoke(null, Platform::Pinterest, [
+            'board_id' => 'some-board',
+            'call_to_action' => ['action_type' => 'BOOK'],
+        ]);
+
+    expect($violation)->toBeNull();
+});

From f471a39958a7f57a6df5a84bd723fde2375debe6 Mon Sep 17 00:00:00 2001
From: Paulo Castellano <paulo@castellanos.llc>
Date: Tue, 11 Aug 2026 00:29:10 -0300
Subject: [PATCH 18/47] test: cover Google Business Profile meta across web,
 API, and MCP entry points

Closes the CLAUDE.md-mandated round-trip coverage gap for PostPlatformMetaRules'
topic_type/call_to_action/event/offer fields, proving they survive the full
validate-then-persist path through all three post entry points, plus a
token-refresh-window regression test for the Google Business rotating
refresh_token model.
---
 tests/Feature/Api/PostApiPlatformMetaTest.php | 39 ++++++++++++++
 .../Commands/RefreshExpiringTokensTest.php    | 31 +++++++++++
 .../Feature/Mcp/PostPlatformMetaToolTest.php  | 45 ++++++++++++++++
 tests/Feature/UpdatePostRequestTest.php       | 54 +++++++++++++++++++
 4 files changed, 169 insertions(+)

diff --git a/tests/Feature/Api/PostApiPlatformMetaTest.php b/tests/Feature/Api/PostApiPlatformMetaTest.php
index 2bfac126b..5f8a2de89 100644
--- a/tests/Feature/Api/PostApiPlatformMetaTest.php
+++ b/tests/Feature/Api/PostApiPlatformMetaTest.php
@@ -389,3 +389,42 @@
             'platforms.0.meta.link' => __('posts.form.pinterest.link_invalid'),
         ]);
 });
+
+it('persists Google Business topic_type and offer meta on store', function () {
+    $googleBusiness = SocialAccount::factory()->googleBusiness()->create(['workspace_id' => $this->workspace->id]);
+
+    $this->withHeaders($this->headers)
+        ->postJson(route('api.posts.store'), [
+            'content' => 'Big sale this week',
+            'platforms' => [[
+                'social_account_id' => $googleBusiness->id,
+                'content_type' => ContentType::GoogleBusinessPost->value,
+                'meta' => [
+                    'topic_type' => 'OFFER',
+                    'offer' => ['coupon_code' => 'SAVE10'],
+                ],
+            ]],
+        ])
+        ->assertCreated();
+
+    $meta = PostPlatform::where('social_account_id', $googleBusiness->id)->sole()->meta;
+
+    expect(data_get($meta, 'topic_type'))->toBe('OFFER')
+        ->and(data_get($meta, 'offer.coupon_code'))->toBe('SAVE10');
+});
+
+it('rejects publishing a Google Business event post without event fields', function () {
+    $googleBusiness = SocialAccount::factory()->googleBusiness()->create(['workspace_id' => $this->workspace->id]);
+    $post = Post::factory()->create(['workspace_id' => $this->workspace->id, 'user_id' => $this->user->id]);
+    $platform = PostPlatform::factory()->googleBusiness()->create([
+        'post_id' => $post->id, 'social_account_id' => $googleBusiness->id, 'enabled' => true, 'meta' => [],
+    ]);
+
+    $this->withHeaders($this->headers)
+        ->putJson(route('api.posts.update', $post), [
+            'status' => PostStatus::Publishing->value,
+            'platforms' => [['id' => $platform->id, 'meta' => ['topic_type' => 'EVENT']]],
+        ])
+        ->assertUnprocessable()
+        ->assertJsonValidationErrors(['platforms.0.meta.event.title']);
+});
diff --git a/tests/Feature/Commands/RefreshExpiringTokensTest.php b/tests/Feature/Commands/RefreshExpiringTokensTest.php
index 957f8f7f6..593ac6804 100644
--- a/tests/Feature/Commands/RefreshExpiringTokensTest.php
+++ b/tests/Feature/Commands/RefreshExpiringTokensTest.php
@@ -119,6 +119,37 @@
     Queue::assertNotPushed(RefreshSocialToken::class, fn ($job) => $job->account->id === $rotating->id);
 });
 
+test('google business profile tokens use the rotating refresh window, not the extension window', function () {
+    Queue::fake();
+
+    $workspace = Workspace::factory()->create();
+
+    // Inside the 30-minute rotating window — should be dispatched.
+    $soon = SocialAccount::factory()->create([
+        'workspace_id' => $workspace->id,
+        'platform' => Platform::GoogleBusiness,
+        'status' => Status::Connected,
+        'token_expires_at' => now()->addMinutes(15),
+    ]);
+
+    // Outside the 30-minute rotating window (but inside the 24-hour extension
+    // window) — must NOT be dispatched, proving Google Business Profile is
+    // treated as a rotating-refresh_token platform, not an extension platform.
+    $outsideRotatingWindow = SocialAccount::factory()->create([
+        'workspace_id' => $workspace->id,
+        'platform' => Platform::GoogleBusiness,
+        'status' => Status::Connected,
+        'token_expires_at' => now()->addHour(),
+    ]);
+
+    $this->artisan('social:refresh-expiring-tokens')
+        ->assertSuccessful();
+
+    Queue::assertPushed(RefreshSocialToken::class, 1);
+    Queue::assertPushed(RefreshSocialToken::class, fn ($job) => $job->account->id === $soon->id);
+    Queue::assertNotPushed(RefreshSocialToken::class, fn ($job) => $job->account->id === $outsideRotatingWindow->id);
+});
+
 test('it dispatches nothing when no tokens are expiring', function () {
     Queue::fake();
 
diff --git a/tests/Feature/Mcp/PostPlatformMetaToolTest.php b/tests/Feature/Mcp/PostPlatformMetaToolTest.php
index 910816385..6acdbeb14 100644
--- a/tests/Feature/Mcp/PostPlatformMetaToolTest.php
+++ b/tests/Feature/Mcp/PostPlatformMetaToolTest.php
@@ -369,3 +369,48 @@
 
     $response->assertHasErrors();
 });
+
+test('create post persists Google Business topic_type and offer meta', function () {
+    $googleBusiness = SocialAccount::factory()->googleBusiness()->create(['workspace_id' => $this->workspace->id]);
+
+    $response = TryPostServer::actingAs($this->user)
+        ->tool(CreatePostTool::class, [
+            'content' => 'Big sale this week',
+            'platforms' => [[
+                'social_account_id' => $googleBusiness->id,
+                'content_type' => ContentType::GoogleBusinessPost->value,
+                'meta' => [
+                    'topic_type' => 'OFFER',
+                    'offer' => ['coupon_code' => 'SAVE10'],
+                ],
+            ]],
+        ]);
+
+    $response->assertOk();
+
+    $meta = PostPlatform::where('social_account_id', $googleBusiness->id)->sole()->meta;
+
+    expect(data_get($meta, 'topic_type'))->toBe('OFFER')
+        ->and(data_get($meta, 'offer.coupon_code'))->toBe('SAVE10');
+});
+
+test('publish post rejects a Google Business event post without event fields', function () {
+    $googleBusiness = SocialAccount::factory()->googleBusiness()->create(['workspace_id' => $this->workspace->id]);
+
+    $post = Post::factory()->create([
+        'workspace_id' => $this->workspace->id,
+        'user_id' => $this->user->id,
+        'status' => PostStatus::Draft,
+    ]);
+    PostPlatform::factory()->googleBusiness()->create([
+        'post_id' => $post->id,
+        'social_account_id' => $googleBusiness->id,
+        'enabled' => true,
+        'meta' => ['topic_type' => 'EVENT'],
+    ]);
+
+    $response = TryPostServer::actingAs($this->user)
+        ->tool(PublishPostTool::class, ['post_id' => $post->id]);
+
+    $response->assertHasErrors([__('posts.form.google_business.event_title_required')]);
+});
diff --git a/tests/Feature/UpdatePostRequestTest.php b/tests/Feature/UpdatePostRequestTest.php
index de6059bda..fde81f7ce 100644
--- a/tests/Feature/UpdatePostRequestTest.php
+++ b/tests/Feature/UpdatePostRequestTest.php
@@ -727,3 +727,57 @@
             'platforms.0.meta.link' => __('posts.form.pinterest.link_invalid'),
         ]);
 });
+
+test('publishing a google business event post without event fields is rejected', function () {
+    $account = SocialAccount::factory()->googleBusiness()->create(['workspace_id' => $this->workspace->id]);
+    $postPlatform = PostPlatform::factory()->googleBusiness()->create([
+        'post_id' => $this->post->id,
+        'social_account_id' => $account->id,
+        'meta' => [],
+    ]);
+
+    $response = $this->actingAs($this->user)
+        ->put(route('app.posts.update', $this->post), [
+            'status' => Status::Publishing->value,
+            'platforms' => [
+                [
+                    'id' => $postPlatform->id,
+                    'content_type' => ContentType::GoogleBusinessPost->value,
+                    'meta' => ['topic_type' => 'EVENT'],
+                ],
+            ],
+        ]);
+
+    $response->assertSessionHasErrors('platforms.0.meta.event.title');
+});
+
+test('publishing a google business offer post round-trips topic_type and offer meta', function () {
+    $account = SocialAccount::factory()->googleBusiness()->create(['workspace_id' => $this->workspace->id]);
+    $postPlatform = PostPlatform::factory()->googleBusiness()->create([
+        'post_id' => $this->post->id,
+        'social_account_id' => $account->id,
+        'meta' => [],
+    ]);
+
+    $response = $this->actingAs($this->user)
+        ->put(route('app.posts.update', $this->post), [
+            'status' => Status::Publishing->value,
+            'platforms' => [
+                [
+                    'id' => $postPlatform->id,
+                    'content_type' => ContentType::GoogleBusinessPost->value,
+                    'meta' => [
+                        'topic_type' => 'OFFER',
+                        'offer' => ['coupon_code' => 'SAVE10'],
+                    ],
+                ],
+            ],
+        ]);
+
+    $response->assertSessionDoesntHaveErrors();
+
+    $meta = $postPlatform->fresh()->meta;
+
+    expect(data_get($meta, 'topic_type'))->toBe('OFFER')
+        ->and(data_get($meta, 'offer.coupon_code'))->toBe('SAVE10');
+});

From ce4016f29d7a0f70d0e133296a47d0fde8953fa5 Mon Sep 17 00:00:00 2001
From: Paulo Castellano <paulo@castellanos.llc>
Date: Tue, 11 Aug 2026 00:34:57 -0300
Subject: [PATCH 19/47] fix: remove redundant ReflectionMethod import in
 PostPlatformMetaRulesTest

The file has no namespace declaration, so ReflectionMethod is already in
the global namespace. Importing it via 'use' is a no-op and raises an error
under the test environment's error-reporting configuration.
---
 tests/Unit/PostPlatformMetaRulesTest.php | 1 -
 1 file changed, 1 deletion(-)

diff --git a/tests/Unit/PostPlatformMetaRulesTest.php b/tests/Unit/PostPlatformMetaRulesTest.php
index 6ecd05bfe..b4ff21ef5 100644
--- a/tests/Unit/PostPlatformMetaRulesTest.php
+++ b/tests/Unit/PostPlatformMetaRulesTest.php
@@ -4,7 +4,6 @@
 
 use App\Enums\SocialAccount\Platform;
 use App\Support\PostPlatformMetaRules;
-use ReflectionMethod;
 
 test('custom meta messages only cover pinterest title and link', function () {
     expect(PostPlatformMetaRules::messages())->toBe([

From 4075623eb674cd9512c4d6ff2605bef7fb4de353 Mon Sep 17 00:00:00 2001
From: Paulo Castellano <paulo@castellanos.llc>
Date: Tue, 11 Aug 2026 00:38:03 -0300
Subject: [PATCH 20/47] fix: add GoogleBusiness case to MediaOptimizer image
 config match

---
 app/Services/Media/MediaOptimizer.php | 6 ++++++
 1 file changed, 6 insertions(+)

diff --git a/app/Services/Media/MediaOptimizer.php b/app/Services/Media/MediaOptimizer.php
index 3370a4a0c..35ed77b94 100644
--- a/app/Services/Media/MediaOptimizer.php
+++ b/app/Services/Media/MediaOptimizer.php
@@ -354,6 +354,12 @@ private function getImageConfig(Platform $platform): array
                 'format' => 'image/jpeg',
                 'quality' => 100,
             ],
+            Platform::GoogleBusiness => [
+                'max_width' => 2048,
+                'max_size' => 5 * 1024 * 1024,
+                'format' => 'image/jpeg',
+                'quality' => 100,
+            ],
         };
     }
 }

From 69cab53122dc11d7e248d016e6a62f4da1d8e79c Mon Sep 17 00:00:00 2001
From: Paulo Castellano <paulo@castellanos.llc>
Date: Tue, 11 Aug 2026 01:01:13 -0300
Subject: [PATCH 21/47] fix: register Google Business Profile in the frontend
 platform enum and OAuth popup routes

Platform.GoogleBusiness was undefined, so the composer settings card never
mounted and the Connect button silently no-opped.
---
 resources/js/composables/useOAuthPopup.ts | 2 ++
 resources/js/types/platform.ts            | 1 +
 2 files changed, 3 insertions(+)

diff --git a/resources/js/composables/useOAuthPopup.ts b/resources/js/composables/useOAuthPopup.ts
index c0a627780..dafcec08e 100644
--- a/resources/js/composables/useOAuthPopup.ts
+++ b/resources/js/composables/useOAuthPopup.ts
@@ -5,6 +5,7 @@ import { toast } from 'vue-sonner';
 import { connect as blueskyConnect } from '@/routes/app/social/bluesky';
 import { connect as discordConnect } from '@/routes/app/social/discord';
 import { connect as facebookConnect } from '@/routes/app/social/facebook';
+import { connect as googleBusinessConnect } from '@/routes/app/social/google-business';
 import { connect as instagramConnect } from '@/routes/app/social/instagram';
 import { connect as instagramFacebookConnect } from '@/routes/app/social/instagram-facebook';
 import { connect as linkedinConnect } from '@/routes/app/social/linkedin';
@@ -23,6 +24,7 @@ const CONNECT_ROUTES: Record<string, { url: () => string }> = {
     [Platform.Bluesky]: blueskyConnect,
     [Platform.Discord]: discordConnect,
     [Platform.Facebook]: facebookConnect,
+    [Platform.GoogleBusiness]: googleBusinessConnect,
     [Platform.Instagram]: instagramConnect,
     [Platform.InstagramFacebook]: instagramFacebookConnect,
     [Platform.LinkedIn]: linkedinConnect,
diff --git a/resources/js/types/platform.ts b/resources/js/types/platform.ts
index 82c863186..d0744d1a4 100644
--- a/resources/js/types/platform.ts
+++ b/resources/js/types/platform.ts
@@ -13,6 +13,7 @@ export const Platform = {
     Mastodon: 'mastodon',
     Telegram: 'telegram',
     Discord: 'discord',
+    GoogleBusiness: 'google_business',
 } as const;
 
 export type PlatformValue = (typeof Platform)[keyof typeof Platform];

From ce92c832a024e79a904e161438235606da0cfcfc Mon Sep 17 00:00:00 2001
From: Paulo Castellano <paulo@castellanos.llc>
Date: Tue, 11 Aug 2026 01:01:19 -0300
Subject: [PATCH 22/47] fix: store the full accounts/*/locations/* name for the
 v4 Local Posts API

The v1 Business Information API returns Location.name in its short
locations/{id} form, but the v4 localPosts endpoint requires the full
accounts/*/locations/* parent. fetchLocationsForAccount now composes the
full name for meta.location_id and keeps the short name in
meta.location_name, which is what the v1 verify call expects.
---
 app/Services/Social/ConnectionVerifier.php      |  4 ++--
 app/Services/Social/GoogleBusinessPublisher.php | 17 +++++++++++++----
 .../Services/Social/ConnectionVerifierTest.php  |  9 +++++++--
 .../Social/GoogleBusinessPublisherTest.php      |  4 ++--
 4 files changed, 24 insertions(+), 10 deletions(-)

diff --git a/app/Services/Social/ConnectionVerifier.php b/app/Services/Social/ConnectionVerifier.php
index 54d3d0da7..7f8e3204e 100644
--- a/app/Services/Social/ConnectionVerifier.php
+++ b/app/Services/Social/ConnectionVerifier.php
@@ -671,10 +671,10 @@ private function verifyMastodon(SocialAccount $account): bool
 
     private function verifyGoogleBusiness(SocialAccount $account): bool
     {
-        $locationId = data_get($account->meta, 'location_id');
+        $locationName = data_get($account->meta, 'location_name');
 
         $response = Http::withToken($account->access_token)
-            ->get(config('trypost.platforms.google_business.business_information_api')."/{$locationId}", [
+            ->get(config('trypost.platforms.google_business.business_information_api')."/{$locationName}", [
                 'readMask' => 'name',
             ]);
 
diff --git a/app/Services/Social/GoogleBusinessPublisher.php b/app/Services/Social/GoogleBusinessPublisher.php
index 230eb74fc..1b30b0e68 100644
--- a/app/Services/Social/GoogleBusinessPublisher.php
+++ b/app/Services/Social/GoogleBusinessPublisher.php
@@ -77,6 +77,10 @@ public function publish(PostPlatform $postPlatform): array
     }
 
     /**
+     * `id` is the full `accounts/{id}/locations/{id}` name the v4 Local Posts API
+     * needs as its parent; `location_name` is the short `locations/{id}` name the
+     * v1 Business Information and Performance APIs expect.
+     *
      * @return list<array{id: string, account_name: string, location_name: string, title: string, address: ?string}>
      */
     public function fetchLocations(string $accessToken): array
@@ -103,7 +107,7 @@ public function getLocations(SocialAccount $account): array
     }
 
     /**
-     * @return array{id: string, account_name: string, location_name: string, title: string, address: ?string}
+     * @return array<string, mixed> The Local Post request body.
      */
     private function buildPayload(PostPlatform $postPlatform, string $content): array
     {
@@ -203,7 +207,7 @@ private function formatTime(string $time): array
     }
 
     /**
-     * Google's `locations/{id}` full resource name → the bare numeric id used
+     * Full `accounts/{id}/locations/{id}` resource name → the bare numeric id used
      * in the dashboard link, matching postiz's synthesized URL shape.
      */
     private function shortLocationId(string $locationId): string
@@ -276,10 +280,15 @@ private function fetchLocationsForAccount(string $accessToken, string $accountNa
             $data = $response->json() ?? [];
 
             foreach (data_get($data, 'locations', []) as $location) {
+                $shortName = (string) data_get($location, 'name');
+                $numericId = str_starts_with($shortName, 'locations/')
+                    ? substr($shortName, strlen('locations/'))
+                    : $shortName;
+
                 $locations[] = [
-                    'id' => (string) data_get($location, 'name'),
+                    'id' => "{$accountName}/locations/{$numericId}",
                     'account_name' => $accountName,
-                    'location_name' => (string) data_get($location, 'name'),
+                    'location_name' => $shortName,
                     'title' => (string) data_get($location, 'title'),
                     'address' => $this->formatAddress(data_get($location, 'storefrontAddress')),
                 ];
diff --git a/tests/Feature/Services/Social/ConnectionVerifierTest.php b/tests/Feature/Services/Social/ConnectionVerifierTest.php
index 96730ceea..ca9d548ae 100644
--- a/tests/Feature/Services/Social/ConnectionVerifierTest.php
+++ b/tests/Feature/Services/Social/ConnectionVerifierTest.php
@@ -9,6 +9,7 @@
 use App\Services\Social\ConnectionVerifier;
 use Illuminate\Http\Client\ConnectionException;
 use Illuminate\Support\Facades\Http;
+use Illuminate\Support\Str;
 
 test('verifies account without refresh when token is not expired', function () {
     Http::fake([
@@ -1201,14 +1202,18 @@
     Http::assertSentCount(1);
 });
 
-test('verify succeeds for a healthy google business token', function () {
+test('verify calls the business information api with the short location name', function () {
     $account = SocialAccount::factory()->googleBusiness()->create();
 
     Http::fake([
-        config('trypost.platforms.google_business.business_information_api').'/*' => Http::response(['name' => $account->meta['location_id']], 200),
+        config('trypost.platforms.google_business.business_information_api').'/*' => Http::response(['name' => $account->meta['location_name']], 200),
     ]);
 
     expect(app(ConnectionVerifier::class)->verify($account))->toBeTrue();
+
+    $expectedUrl = config('trypost.platforms.google_business.business_information_api')."/{$account->meta['location_name']}";
+
+    Http::assertSent(fn ($request) => Str::before($request->url(), '?') === $expectedUrl);
 });
 
 test('verify throws token expired for a dead google business token', function () {
diff --git a/tests/Feature/Services/Social/GoogleBusinessPublisherTest.php b/tests/Feature/Services/Social/GoogleBusinessPublisherTest.php
index 4cbeaa8b9..b2601588b 100644
--- a/tests/Feature/Services/Social/GoogleBusinessPublisherTest.php
+++ b/tests/Feature/Services/Social/GoogleBusinessPublisherTest.php
@@ -154,7 +154,7 @@
         ], 200),
         config('trypost.platforms.google_business.business_information_api').'/accounts/111/locations*' => Http::response([
             'locations' => [
-                ['name' => 'accounts/111/locations/222', 'title' => 'Downtown Store', 'storefrontAddress' => ['addressLines' => ['123 Main St'], 'locality' => 'Springfield']],
+                ['name' => 'locations/222', 'title' => 'Downtown Store', 'storefrontAddress' => ['addressLines' => ['123 Main St'], 'locality' => 'Springfield']],
             ],
         ], 200),
     ]);
@@ -165,7 +165,7 @@
     expect($locations[0])->toMatchArray([
         'id' => 'accounts/111/locations/222',
         'account_name' => 'accounts/111',
-        'location_name' => 'accounts/111/locations/222',
+        'location_name' => 'locations/222',
         'title' => 'Downtown Store',
         'address' => '123 Main St, Springfield',
     ]);

From 74b4f0c7abcef0aee7d2de90b9d5ce2c3ee8a55f Mon Sep 17 00:00:00 2001
From: Paulo Castellano <paulo@castellanos.llc>
Date: Tue, 11 Aug 2026 01:01:23 -0300
Subject: [PATCH 23/47] fix: wire Google Business Profile analytics into the
 analytics controller

The controller had no SUPPORTED_PLATFORMS entry or match arm, so the
service was unreachable. The Performance API call also used the full
location resource name (it wants the short one) and encoded dailyMetrics
as bracket-indexed array params instead of repeated scalars.
---
 .../Controllers/App/AnalyticsController.php   |  3 +
 .../Social/GoogleBusinessAnalytics.php        | 38 ++++++---
 .../Social/GoogleBusinessAnalyticsTest.php    | 85 +++++++++++++++++++
 3 files changed, 115 insertions(+), 11 deletions(-)

diff --git a/app/Http/Controllers/App/AnalyticsController.php b/app/Http/Controllers/App/AnalyticsController.php
index cac42f7c6..0ebfa04d3 100644
--- a/app/Http/Controllers/App/AnalyticsController.php
+++ b/app/Http/Controllers/App/AnalyticsController.php
@@ -8,6 +8,7 @@
 use App\Http\Controllers\Controller;
 use App\Models\SocialAccount;
 use App\Services\Social\FacebookAnalytics;
+use App\Services\Social\GoogleBusinessAnalytics;
 use App\Services\Social\InstagramAnalytics;
 use App\Services\Social\LinkedInPageAnalytics;
 use App\Services\Social\PinterestAnalytics;
@@ -36,6 +37,7 @@ class AnalyticsController extends Controller
         Platform::Pinterest,
         Platform::YouTube,
         Platform::Telegram,
+        Platform::GoogleBusiness,
     ];
 
     public function index(Request $request): Response
@@ -82,6 +84,7 @@ public function show(Request $request, SocialAccount $account): JsonResponse
             Platform::Pinterest => app(PinterestAnalytics::class)->getMetrics($account, $since, $until),
             Platform::YouTube => app(YouTubeAnalytics::class)->getMetrics($account, $since, $until),
             Platform::Telegram => app(TelegramAnalytics::class)->getMetrics($account),
+            Platform::GoogleBusiness => app(GoogleBusinessAnalytics::class)->getMetrics($account, $since, $until),
             default => [],
         };
 
diff --git a/app/Services/Social/GoogleBusinessAnalytics.php b/app/Services/Social/GoogleBusinessAnalytics.php
index e46c7abb7..3b5f7ddc9 100644
--- a/app/Services/Social/GoogleBusinessAnalytics.php
+++ b/app/Services/Social/GoogleBusinessAnalytics.php
@@ -38,22 +38,14 @@ public function getMetrics(SocialAccount $account, ?CarbonInterface $since = nul
             app(ConnectionVerifier::class)->refreshToken($account);
         }
 
-        $locationId = (string) data_get($account->meta, 'location_id');
+        $locationName = (string) data_get($account->meta, 'location_name');
 
-        if (blank($locationId)) {
+        if (blank($locationName)) {
             return [];
         }
 
         $response = $this->socialHttp()->withToken($account->access_token)
-            ->get("{$this->baseUrl}/{$locationId}:fetchMultiDailyMetricsTimeSeries", [
-                'dailyMetrics' => array_keys(self::METRICS),
-                'dailyRange.start_date.year' => $since->format('Y'),
-                'dailyRange.start_date.month' => $since->format('n'),
-                'dailyRange.start_date.day' => $since->format('j'),
-                'dailyRange.end_date.year' => $until->format('Y'),
-                'dailyRange.end_date.month' => $until->format('n'),
-                'dailyRange.end_date.day' => $until->format('j'),
-            ]);
+            ->get("{$this->baseUrl}/{$locationName}:fetchMultiDailyMetricsTimeSeries?{$this->buildQuery($since, $until)}");
 
         if ($response->failed()) {
             Log::warning('Google Business Profile analytics fetch failed', [
@@ -85,4 +77,28 @@ public function getMetrics(SocialAccount $account, ?CarbonInterface $since = nul
             ->values()
             ->all();
     }
+
+    /**
+     * Google expects `dailyMetrics` as repeated scalar params, which
+     * `http_build_query` (and therefore the HTTP client's array query support)
+     * would encode as `dailyMetrics[0]=...` instead.
+     */
+    private function buildQuery(CarbonInterface $since, CarbonInterface $until): string
+    {
+        $metrics = implode('&', array_map(
+            fn (string $metric): string => 'dailyMetrics='.urlencode($metric),
+            array_keys(self::METRICS),
+        ));
+
+        $range = http_build_query([
+            'dailyRange.start_date.year' => $since->format('Y'),
+            'dailyRange.start_date.month' => $since->format('n'),
+            'dailyRange.start_date.day' => $since->format('j'),
+            'dailyRange.end_date.year' => $until->format('Y'),
+            'dailyRange.end_date.month' => $until->format('n'),
+            'dailyRange.end_date.day' => $until->format('j'),
+        ]);
+
+        return "{$metrics}&{$range}";
+    }
 }
diff --git a/tests/Feature/Services/Social/GoogleBusinessAnalyticsTest.php b/tests/Feature/Services/Social/GoogleBusinessAnalyticsTest.php
index a5d086234..6e06c196c 100644
--- a/tests/Feature/Services/Social/GoogleBusinessAnalyticsTest.php
+++ b/tests/Feature/Services/Social/GoogleBusinessAnalyticsTest.php
@@ -2,18 +2,34 @@
 
 declare(strict_types=1);
 
+use App\Enums\SocialAccount\Platform;
+use App\Enums\SocialAccount\Status as AccountStatus;
+use App\Enums\UserWorkspace\Role;
+use App\Models\Account;
 use App\Models\SocialAccount;
 use App\Models\User;
 use App\Models\Workspace;
 use App\Services\Social\GoogleBusinessAnalytics;
 use Illuminate\Support\Facades\Http;
+use Illuminate\Support\Str;
 
 beforeEach(function () {
     $this->user = User::factory()->create();
     $this->workspace = Workspace::factory()->create(['user_id' => $this->user->id]);
+    $this->workspace->members()->attach($this->user->id, ['role' => Role::Member->value]);
+    $this->user->account->subscriptions()->create([
+        'type' => Account::SUBSCRIPTION_NAME,
+        'stripe_id' => 'sub_test_'.fake()->uuid(),
+        'stripe_status' => 'active',
+        'stripe_price' => 'price_123',
+    ]);
+    $this->user->update(['current_workspace_id' => $this->workspace->id]);
+
     $this->socialAccount = SocialAccount::factory()->googleBusiness()->create([
         'workspace_id' => $this->workspace->id,
         'token_expires_at' => now()->addHour(),
+        'status' => AccountStatus::Connected,
+        'is_active' => true,
     ]);
     $this->analytics = new GoogleBusinessAnalytics;
 });
@@ -47,6 +63,75 @@
     expect($websiteClicks['value'])->toBe(15);
 });
 
+test('requests the short location resource name with repeated dailyMetrics params', function () {
+    Http::fake([
+        config('trypost.platforms.google_business.performance_api').'/*' => Http::response(['multiDailyMetricTimeSeries' => []], 200),
+    ]);
+
+    $this->analytics->getMetrics($this->socialAccount);
+
+    $expectedUrl = config('trypost.platforms.google_business.performance_api')
+        ."/{$this->socialAccount->meta['location_name']}:fetchMultiDailyMetricsTimeSeries";
+
+    Http::assertSent(function ($request) use ($expectedUrl) {
+        $query = (string) parse_url($request->url(), PHP_URL_QUERY);
+
+        return Str::before($request->url(), '?') === $expectedUrl
+            && Str::contains($query, 'dailyMetrics=WEBSITE_CLICKS')
+            && Str::contains($query, 'dailyMetrics=CALL_CLICKS')
+            && Str::contains($query, 'dailyMetrics=BUSINESS_IMPRESSIONS_MOBILE_MAPS')
+            && ! Str::contains($query, 'dailyMetrics%5B')
+            && ! Str::contains($query, 'dailyMetrics[');
+    });
+});
+
+test('returns empty array when the account has no location', function () {
+    Http::fake();
+
+    $this->socialAccount->update(['meta' => ['location_id' => 'accounts/1/locations/2']]);
+
+    expect($this->analytics->getMetrics($this->socialAccount->fresh()))->toBe([]);
+
+    Http::assertNothingSent();
+});
+
+test('google business is listed on the analytics page', function () {
+    $response = $this->actingAs($this->user)->get(route('app.analytics'));
+
+    $response->assertOk();
+
+    $accounts = $response->original->getData()['page']['props']['accounts'];
+
+    expect(collect($accounts)->firstWhere('platform', Platform::GoogleBusiness->value))->not->toBeNull();
+});
+
+test('the analytics show endpoint returns google business metrics', function () {
+    Http::fake([
+        config('trypost.platforms.google_business.performance_api').'/*' => Http::response([
+            'multiDailyMetricTimeSeries' => [
+                [
+                    'dailyMetricTimeSeries' => [
+                        [
+                            'dailyMetric' => 'WEBSITE_CLICKS',
+                            'timeSeries' => ['datedValues' => [['value' => '7']]],
+                        ],
+                    ],
+                ],
+            ],
+        ], 200),
+    ]);
+
+    $response = $this->actingAs($this->user)
+        ->getJson(route('app.analytics.show', $this->socialAccount));
+
+    $response->assertOk()->assertJsonCount(5, 'metrics');
+
+    $metrics = $response->json('metrics');
+
+    expect(collect($metrics)->pluck('label')->filter())->toHaveCount(5)
+        ->and(collect($metrics)->firstWhere('label', __('analytics.metrics.website_clicks'))['value'])->toBe(7);
+});
+
 test('returns empty array on api failure', function () {
     Http::fake([
         config('trypost.platforms.google_business.performance_api').'/*' => Http::response([], 500),

From f31b8403e69bbd86f0d27377c4a1a358e652a152 Mon Sep 17 00:00:00 2001
From: Paulo Castellano <paulo@castellanos.llc>
Date: Tue, 11 Aug 2026 01:01:27 -0300
Subject: [PATCH 24/47] fix: gate Google Business Profile publish on its
 required meta client-side

Mirrors PostPlatformMetaRules::requiredMetaViolation() so the composer
shows an inline tooltip instead of letting the user hit a raw 422.
---
 resources/js/composables/usePostCompliance.ts | 21 +++++++++++++++++++
 1 file changed, 21 insertions(+)

diff --git a/resources/js/composables/usePostCompliance.ts b/resources/js/composables/usePostCompliance.ts
index 0ee49eb60..d4319bd2a 100644
--- a/resources/js/composables/usePostCompliance.ts
+++ b/resources/js/composables/usePostCompliance.ts
@@ -65,6 +65,27 @@ const PLATFORM_META_RULES: Record<string, MetaRule> = {
         valid: Boolean(meta.channel_id),
         tooltipKey: meta.channel_id ? null : 'posts.form.discord.channel_required',
     }),
+    // Mirrors PostPlatformMetaRules::requiredMetaViolation()'s Google Business
+    // arms, including their check order.
+    [Platform.GoogleBusiness]: (meta) => {
+        const isEvent = (meta.topic_type ?? 'STANDARD') === 'EVENT';
+        const ctaActionType = meta.call_to_action?.action_type ?? 'NONE';
+        const ctaNeedsUrl = !['NONE', 'CALL'].includes(ctaActionType);
+        let tooltipKey: string | null = null;
+        if (isEvent && !meta.event?.title) {
+            tooltipKey = 'posts.form.google_business.event_title_required';
+        } else if (isEvent && !meta.event?.start_date) {
+            tooltipKey = 'posts.form.google_business.event_start_date_required';
+        } else if (isEvent && !meta.event?.end_date) {
+            tooltipKey = 'posts.form.google_business.event_end_date_required';
+        } else if (ctaNeedsUrl && !meta.call_to_action?.url) {
+            tooltipKey = 'posts.form.google_business.cta_url_required';
+        }
+        return {
+            valid: tooltipKey === null,
+            tooltipKey,
+        };
+    },
 };
 
 /**

From 83f3a43974c7ebb1d04500546d8c4321cd990294 Mon Sep 17 00:00:00 2001
From: Paulo Castellano <paulo@castellanos.llc>
Date: Tue, 11 Aug 2026 01:01:27 -0300
Subject: [PATCH 25/47] fix: translate the Google Business Profile preview CTA
 labels

---
 .../posts/previews/GoogleBusinessPreview.vue  | 19 ++++++++++---------
 1 file changed, 10 insertions(+), 9 deletions(-)

diff --git a/resources/js/components/posts/previews/GoogleBusinessPreview.vue b/resources/js/components/posts/previews/GoogleBusinessPreview.vue
index df40a564f..08de920cc 100644
--- a/resources/js/components/posts/previews/GoogleBusinessPreview.vue
+++ b/resources/js/components/posts/previews/GoogleBusinessPreview.vue
@@ -1,4 +1,5 @@
 <script setup lang="ts">
+import { trans } from 'laravel-vue-i18n';
 import { computed } from 'vue';
 
 import { getInitials } from '@/composables/useInitials';
@@ -27,17 +28,17 @@ const ctaLabel = computed(() => {
 
     if (!type || type === 'NONE') return null;
 
-    const labels: Record<string, string> = {
-        BOOK: 'Book',
-        ORDER: 'Order online',
-        SHOP: 'Buy',
-        LEARN_MORE: 'Learn more',
-        SIGN_UP: 'Sign up',
-        GET_OFFER: 'Redeem offer',
-        CALL: 'Call now',
+    const labelKeys: Record<string, string> = {
+        BOOK: 'posts.form.google_business.cta.book',
+        ORDER: 'posts.form.google_business.cta.order',
+        SHOP: 'posts.form.google_business.cta.shop',
+        LEARN_MORE: 'posts.form.google_business.cta.learn_more',
+        SIGN_UP: 'posts.form.google_business.cta.sign_up',
+        GET_OFFER: 'posts.form.google_business.cta.get_offer',
+        CALL: 'posts.form.google_business.cta.call',
     };
 
-    return labels[type] ?? null;
+    return labelKeys[type] ? trans(labelKeys[type]) : null;
 });
 </script>
 

From d84e13743e83ff0ee587843714e5e544641d1f8c Mon Sep 17 00:00:00 2001
From: Paulo Castellano <paulo@castellanos.llc>
Date: Tue, 11 Aug 2026 01:01:27 -0300
Subject: [PATCH 26/47] fix: add the Google Business Profile arm to
 SocialAccount::profile_url

---
 app/Models/SocialAccount.php             |  3 +++
 tests/Feature/SocialAccountModelTest.php | 19 +++++++++++++++++++
 2 files changed, 22 insertions(+)

diff --git a/app/Models/SocialAccount.php b/app/Models/SocialAccount.php
index 61adc357b..06f74ba8a 100644
--- a/app/Models/SocialAccount.php
+++ b/app/Models/SocialAccount.php
@@ -146,6 +146,9 @@ protected function profileUrl(): Attribute
                         ? rtrim((string) data_get($this->meta, 'instance'), '/')."/@{$username}"
                         : null,
                     SocialPlatform::Telegram => $username ? "https://t.me/{$username}" : null,
+                    SocialPlatform::GoogleBusiness => data_get($this->meta, 'location_id')
+                        ? 'https://business.google.com/locations/'.last(explode('/', (string) data_get($this->meta, 'location_id')))
+                        : null,
                     default => null,
                 };
             },
diff --git a/tests/Feature/SocialAccountModelTest.php b/tests/Feature/SocialAccountModelTest.php
index 9be609c75..5b666459c 100644
--- a/tests/Feature/SocialAccountModelTest.php
+++ b/tests/Feature/SocialAccountModelTest.php
@@ -214,3 +214,22 @@
     Event::assertDispatched(NotificationCreated::class);
     Mail::assertQueued(AccountDisconnected::class);
 });
+
+// ---- profile_url ----
+
+test('profile_url for google business points at the location dashboard', function () {
+    $account = SocialAccount::factory()->googleBusiness()->create([
+        'workspace_id' => $this->workspace->id,
+    ]);
+
+    expect($account->profile_url)->toBe('https://business.google.com/locations/987654321');
+});
+
+test('profile_url for google business is null without a stored location', function () {
+    $account = SocialAccount::factory()->googleBusiness()->create([
+        'workspace_id' => $this->workspace->id,
+        'meta' => ['google_user_id' => 'google-user-123'],
+    ]);
+
+    expect($account->profile_url)->toBeNull();
+});

From 5251ffb60ac9733049f2e5abb31afb9aa9e38db4 Mon Sep 17 00:00:00 2001
From: Paulo Castellano <paulo@castellanos.llc>
Date: Tue, 11 Aug 2026 08:15:53 -0300
Subject: [PATCH 27/47] fix: send the event object for Google Business OFFER
 posts too

Google's v4 Local Posts API requires the `event` field for both the EVENT
and OFFER topic types, so Offer posts were being rejected with
INVALID_ARGUMENT because no `event` object was ever attached.

Both topic types now reuse the same `meta.event.*` fields (title + date
range), matching the API shape and Google's own Business Profile app flow,
where creating an Offer also asks for a title and date range before the
coupon details. The backend publish requirement, the editor sub-form, and
the frontend compliance gate are all gated on the shared topic-type list.
---
 .../Social/GoogleBusinessPublisher.php        |  6 +++-
 app/Support/PostPlatformMetaRules.php         | 14 ++++++++--
 .../posts/editor/GoogleBusinessSettings.vue   |  5 +++-
 resources/js/composables/usePostCompliance.ts |  9 +++---
 resources/js/lib/googleBusiness.ts            | 10 +++++++
 .../Social/GoogleBusinessPublisherTest.php    | 28 +++++++++++++++++++
 tests/Feature/UpdatePostRequestTest.php       | 28 +++++++++++++++++++
 tests/Unit/PostPlatformMetaRulesTest.php      | 27 ++++++++++++++++++
 8 files changed, 118 insertions(+), 9 deletions(-)
 create mode 100644 resources/js/lib/googleBusiness.ts

diff --git a/app/Services/Social/GoogleBusinessPublisher.php b/app/Services/Social/GoogleBusinessPublisher.php
index 1b30b0e68..81c217427 100644
--- a/app/Services/Social/GoogleBusinessPublisher.php
+++ b/app/Services/Social/GoogleBusinessPublisher.php
@@ -141,7 +141,7 @@ private function buildPayload(PostPlatform $postPlatform, string $content): arra
             ]];
         }
 
-        if ($topicType === 'EVENT') {
+        if (in_array($topicType, ['EVENT', 'OFFER'], true)) {
             $payload['event'] = $this->buildEvent($postPlatform);
         }
 
@@ -156,6 +156,10 @@ private function buildPayload(PostPlatform $postPlatform, string $content): arra
         return $payload;
     }
 
+    /**
+     * The v4 Local Posts API requires `event` for both the EVENT and OFFER topic
+     * types, so both read the same `meta.event.*` fields.
+     */
     private function buildEvent(PostPlatform $postPlatform): array
     {
         $schedule = [
diff --git a/app/Support/PostPlatformMetaRules.php b/app/Support/PostPlatformMetaRules.php
index 9ede518e4..384dd9975 100644
--- a/app/Support/PostPlatformMetaRules.php
+++ b/app/Support/PostPlatformMetaRules.php
@@ -31,6 +31,14 @@ class PostPlatformMetaRules
         'SELF_ONLY',
     ];
 
+    /**
+     * Google Business Profile topic types whose Local Post requires an `event`
+     * object — Google mandates it for OFFER just as much as for EVENT.
+     *
+     * @var array<int, string>
+     */
+    public const GOOGLE_BUSINESS_EVENT_TOPIC_TYPES = ['EVENT', 'OFFER'];
+
     /**
      * Validation rules for `platforms.*.meta` and all its per-platform sub-keys.
      * Spread into a FormRequest/MCP tool rule set as the complete meta contract.
@@ -185,13 +193,13 @@ private static function requiredMetaViolation(?Platform $platform, mixed $meta):
             $platform === Platform::Pinterest && blank(data_get($meta, 'board_id')) => ['board_id', trans('posts.form.pinterest.board_required')],
             $platform === Platform::Discord && blank(data_get($meta, 'channel_id')) => ['channel_id', trans('posts.form.discord.channel_required')],
             $platform === Platform::GoogleBusiness
-                && data_get($meta, 'topic_type', 'STANDARD') === 'EVENT'
+                && in_array(data_get($meta, 'topic_type', 'STANDARD'), self::GOOGLE_BUSINESS_EVENT_TOPIC_TYPES, true)
                 && blank(data_get($meta, 'event.title')) => ['event.title', trans('posts.form.google_business.event_title_required')],
             $platform === Platform::GoogleBusiness
-                && data_get($meta, 'topic_type', 'STANDARD') === 'EVENT'
+                && in_array(data_get($meta, 'topic_type', 'STANDARD'), self::GOOGLE_BUSINESS_EVENT_TOPIC_TYPES, true)
                 && blank(data_get($meta, 'event.start_date')) => ['event.start_date', trans('posts.form.google_business.event_start_date_required')],
             $platform === Platform::GoogleBusiness
-                && data_get($meta, 'topic_type', 'STANDARD') === 'EVENT'
+                && in_array(data_get($meta, 'topic_type', 'STANDARD'), self::GOOGLE_BUSINESS_EVENT_TOPIC_TYPES, true)
                 && blank(data_get($meta, 'event.end_date')) => ['event.end_date', trans('posts.form.google_business.event_end_date_required')],
             $platform === Platform::GoogleBusiness
                 && ! in_array(data_get($meta, 'call_to_action.action_type', 'NONE'), ['NONE', 'CALL'], true)
diff --git a/resources/js/components/posts/editor/GoogleBusinessSettings.vue b/resources/js/components/posts/editor/GoogleBusinessSettings.vue
index 1611d6b27..108845ae7 100644
--- a/resources/js/components/posts/editor/GoogleBusinessSettings.vue
+++ b/resources/js/components/posts/editor/GoogleBusinessSettings.vue
@@ -8,6 +8,7 @@ import { Input } from '@/components/ui/input';
 import { Textarea } from '@/components/ui/textarea';
 import { usePageErrors } from '@/composables/usePageErrors';
 import { getPlatformLogo } from '@/composables/usePlatformLogo';
+import { GOOGLE_BUSINESS_EVENT_TOPIC_TYPES } from '@/lib/googleBusiness';
 
 interface SocialAccount {
     id: string;
@@ -68,6 +69,8 @@ const ctaActionType = computed<string>({
 
 const showCtaUrl = computed(() => ctaActionType.value !== 'NONE' && ctaActionType.value !== 'CALL');
 
+const showEventFields = computed(() => GOOGLE_BUSINESS_EVENT_TOPIC_TYPES.includes(topicType.value));
+
 const ctaUrl = computed<string>({
     get: () => props.meta?.call_to_action?.url || '',
     set: (value: string) => emit('update:meta', {
@@ -160,7 +163,7 @@ const ctaUrlError = findError('.meta.call_to_action.url');
                 </div>
             </div>
 
-            <div v-if="topicType === 'EVENT'" class="grid grid-cols-2 gap-3">
+            <div v-if="showEventFields" class="grid grid-cols-2 gap-3">
                 <div class="col-span-2 space-y-2">
                     <p class="text-[11px] font-black uppercase tracking-widest text-foreground/60">{{ $t('posts.form.google_business.event_title') }}</p>
                     <Input v-model="eventTitle" type="text" :placeholder="$t('posts.form.google_business.event_title_placeholder')" :disabled="disabled || previewOnly" :class="eventTitleError ? 'border-rose-500' : undefined" />
diff --git a/resources/js/composables/usePostCompliance.ts b/resources/js/composables/usePostCompliance.ts
index d4319bd2a..c91f0a7df 100644
--- a/resources/js/composables/usePostCompliance.ts
+++ b/resources/js/composables/usePostCompliance.ts
@@ -4,6 +4,7 @@ import { computed, type ComputedRef, type Ref } from 'vue';
 import { getMediaItemIssue, getMediaValidationWarning } from '@/composables/useMedia';
 import { getMediaRulesForContentType } from '@/composables/useMediaRules';
 import { getPlatformLabel } from '@/composables/usePlatformLogo';
+import { GOOGLE_BUSINESS_EVENT_TOPIC_TYPES } from '@/lib/googleBusiness';
 import { ContentType } from '@/types/content-type';
 import type { MediaItem } from '@/types/media';
 import { Platform } from '@/types/platform';
@@ -68,15 +69,15 @@ const PLATFORM_META_RULES: Record<string, MetaRule> = {
     // Mirrors PostPlatformMetaRules::requiredMetaViolation()'s Google Business
     // arms, including their check order.
     [Platform.GoogleBusiness]: (meta) => {
-        const isEvent = (meta.topic_type ?? 'STANDARD') === 'EVENT';
+        const needsEvent = GOOGLE_BUSINESS_EVENT_TOPIC_TYPES.includes(meta.topic_type ?? 'STANDARD');
         const ctaActionType = meta.call_to_action?.action_type ?? 'NONE';
         const ctaNeedsUrl = !['NONE', 'CALL'].includes(ctaActionType);
         let tooltipKey: string | null = null;
-        if (isEvent && !meta.event?.title) {
+        if (needsEvent && !meta.event?.title) {
             tooltipKey = 'posts.form.google_business.event_title_required';
-        } else if (isEvent && !meta.event?.start_date) {
+        } else if (needsEvent && !meta.event?.start_date) {
             tooltipKey = 'posts.form.google_business.event_start_date_required';
-        } else if (isEvent && !meta.event?.end_date) {
+        } else if (needsEvent && !meta.event?.end_date) {
             tooltipKey = 'posts.form.google_business.event_end_date_required';
         } else if (ctaNeedsUrl && !meta.call_to_action?.url) {
             tooltipKey = 'posts.form.google_business.cta_url_required';
diff --git a/resources/js/lib/googleBusiness.ts b/resources/js/lib/googleBusiness.ts
new file mode 100644
index 000000000..adc085b81
--- /dev/null
+++ b/resources/js/lib/googleBusiness.ts
@@ -0,0 +1,10 @@
+/**
+ * Google Business Profile Local Post constants shared by the editor settings
+ * panel, the preview, and the publish compliance gate.
+ */
+
+/**
+ * Topic types whose Local Post requires an `event` object (title + date range).
+ * Mirrors PostPlatformMetaRules::GOOGLE_BUSINESS_EVENT_TOPIC_TYPES.
+ */
+export const GOOGLE_BUSINESS_EVENT_TOPIC_TYPES: string[] = ['EVENT', 'OFFER'];
diff --git a/tests/Feature/Services/Social/GoogleBusinessPublisherTest.php b/tests/Feature/Services/Social/GoogleBusinessPublisherTest.php
index b2601588b..1d4ccf9fd 100644
--- a/tests/Feature/Services/Social/GoogleBusinessPublisherTest.php
+++ b/tests/Feature/Services/Social/GoogleBusinessPublisherTest.php
@@ -112,6 +112,34 @@
     });
 });
 
+test('builds both an event and an offer payload for OFFER topic type', function () {
+    Http::fake([
+        config('trypost.platforms.google_business.local_posts_api').'/*' => Http::response(['name' => 'x'], 200),
+    ]);
+
+    $this->postPlatform->update([
+        'meta' => [
+            'topic_type' => 'OFFER',
+            'event' => ['title' => 'Summer Sale', 'start_date' => '2026-09-01', 'end_date' => '2026-09-30'],
+            'offer' => ['coupon_code' => 'SUMMER20'],
+        ],
+    ]);
+
+    $this->publisher->publish($this->postPlatform->fresh());
+
+    Http::assertSent(function ($request) {
+        return data_get($request->data(), 'topicType') === 'OFFER'
+            && data_get($request->data(), 'event') === [
+                'title' => 'Summer Sale',
+                'schedule' => [
+                    'startDate' => ['year' => 2026, 'month' => 9, 'day' => 1],
+                    'endDate' => ['year' => 2026, 'month' => 9, 'day' => 30],
+                ],
+            ]
+            && data_get($request->data(), 'offer') === ['couponCode' => 'SUMMER20'];
+    });
+});
+
 test('rejects video media for google business posts', function () {
     $this->post->update([
         'media' => [[
diff --git a/tests/Feature/UpdatePostRequestTest.php b/tests/Feature/UpdatePostRequestTest.php
index fde81f7ce..bd78390c0 100644
--- a/tests/Feature/UpdatePostRequestTest.php
+++ b/tests/Feature/UpdatePostRequestTest.php
@@ -768,6 +768,7 @@
                     'content_type' => ContentType::GoogleBusinessPost->value,
                     'meta' => [
                         'topic_type' => 'OFFER',
+                        'event' => ['title' => 'Summer Sale', 'start_date' => '2026-09-01', 'end_date' => '2026-09-30'],
                         'offer' => ['coupon_code' => 'SAVE10'],
                     ],
                 ],
@@ -779,5 +780,32 @@
     $meta = $postPlatform->fresh()->meta;
 
     expect(data_get($meta, 'topic_type'))->toBe('OFFER')
+        ->and(data_get($meta, 'event.title'))->toBe('Summer Sale')
         ->and(data_get($meta, 'offer.coupon_code'))->toBe('SAVE10');
 });
+
+test('publishing a google business offer post requires the event title', function () {
+    $account = SocialAccount::factory()->googleBusiness()->create(['workspace_id' => $this->workspace->id]);
+    $postPlatform = PostPlatform::factory()->googleBusiness()->create([
+        'post_id' => $this->post->id,
+        'social_account_id' => $account->id,
+        'meta' => [],
+    ]);
+
+    $response = $this->actingAs($this->user)
+        ->put(route('app.posts.update', $this->post), [
+            'status' => Status::Publishing->value,
+            'platforms' => [
+                [
+                    'id' => $postPlatform->id,
+                    'content_type' => ContentType::GoogleBusinessPost->value,
+                    'meta' => [
+                        'topic_type' => 'OFFER',
+                        'offer' => ['coupon_code' => 'SAVE10'],
+                    ],
+                ],
+            ],
+        ]);
+
+    $response->assertSessionHasErrors('platforms.0.meta.event.title');
+});
diff --git a/tests/Unit/PostPlatformMetaRulesTest.php b/tests/Unit/PostPlatformMetaRulesTest.php
index b4ff21ef5..4299b4cfb 100644
--- a/tests/Unit/PostPlatformMetaRulesTest.php
+++ b/tests/Unit/PostPlatformMetaRulesTest.php
@@ -60,6 +60,33 @@
     expect($violation)->toBeNull();
 });
 
+test('google business offer topic type requires event title, start date, and end date to publish', function () {
+    $method = new ReflectionMethod(PostPlatformMetaRules::class, 'requiredMetaViolation');
+
+    expect($method->invoke(null, Platform::GoogleBusiness, ['topic_type' => 'OFFER'])[0])->toBe('event.title');
+
+    expect($method->invoke(null, Platform::GoogleBusiness, [
+        'topic_type' => 'OFFER',
+        'event' => ['title' => 'Summer Sale'],
+    ])[0])->toBe('event.start_date');
+
+    expect($method->invoke(null, Platform::GoogleBusiness, [
+        'topic_type' => 'OFFER',
+        'event' => ['title' => 'Summer Sale', 'start_date' => '2026-09-01'],
+    ])[0])->toBe('event.end_date');
+});
+
+test('google business offer topic type with all event fields present has no violation', function () {
+    $violation = (new ReflectionMethod(PostPlatformMetaRules::class, 'requiredMetaViolation'))
+        ->invoke(null, Platform::GoogleBusiness, [
+            'topic_type' => 'OFFER',
+            'event' => ['title' => 'Summer Sale', 'start_date' => '2026-09-01', 'end_date' => '2026-09-30'],
+            'offer' => ['coupon_code' => 'SUMMER20'],
+        ]);
+
+    expect($violation)->toBeNull();
+});
+
 test('google business meta rules validate topic_type and call_to_action shape', function () {
     $rules = PostPlatformMetaRules::rules();
 

From 9264b35a4442ab58ed4161e6ceaebf225e4afdbb Mon Sep 17 00:00:00 2001
From: Paulo Castellano <paulo@castellanos.llc>
Date: Tue, 11 Aug 2026 08:17:22 -0300
Subject: [PATCH 28/47] fix: scope Google Business Profile validation errors to
 their own location

findError() matched backend error keys by suffix only, so a post targeting
two Google Business Profile locations showed one location's error under
both settings panels.

ChannelConfigurator now passes each settings panel its position in the
selected-channel list, and GoogleBusinessSettings matches the full
`platforms.{index}.meta.*` key. That position is the submitted index: the
editor builds the `platforms` payload by filtering the same post_platforms
list by the same selection, which is the mapping ScheduleTab already relies
on for content-type errors.

Pinterest and Discord share the same suffix-match limitation; fixing them
is left to a separate change.
---
 .../js/components/ChannelConfigurator.vue     |  6 +++++-
 .../posts/editor/GoogleBusinessSettings.vue   | 19 +++++++++++--------
 2 files changed, 16 insertions(+), 9 deletions(-)

diff --git a/resources/js/components/ChannelConfigurator.vue b/resources/js/components/ChannelConfigurator.vue
index 6b58e98ed..de642c52e 100644
--- a/resources/js/components/ChannelConfigurator.vue
+++ b/resources/js/components/ChannelConfigurator.vue
@@ -40,6 +40,9 @@ const emit = defineEmits<{
 
 const isSelected = (id: string): boolean => props.selectedIds.includes(id);
 
+// Order matches the `platforms` array the editor submits (both filter the same
+// post_platforms list by the same selection), so a settings panel's position
+// here is the `platforms.{index}.*` index its backend errors are keyed by.
 const selectedChannels = computed(() => props.channels.filter((channel) => isSelected(channel.id)));
 </script>
 
@@ -111,7 +114,7 @@ const selectedChannels = computed(() => props.channels.filter((channel) => isSel
 
         <slot />
 
-        <template v-for="channel in selectedChannels" :key="channel.id">
+        <template v-for="(channel, index) in selectedChannels" :key="channel.id">
             <InstagramSettings
                 v-if="channel.platform === Platform.Instagram || channel.platform === Platform.InstagramFacebook"
                 :social-account="channel.socialAccount"
@@ -182,6 +185,7 @@ const selectedChannels = computed(() => props.channels.filter((channel) => isSel
             <GoogleBusinessSettings
                 v-else-if="channel.platform === Platform.GoogleBusiness"
                 :social-account="channel.socialAccount"
+                :platform-index="index"
                 :meta="channel.meta"
                 :disabled="disabled"
                 :preview-only="previewOnly"
diff --git a/resources/js/components/posts/editor/GoogleBusinessSettings.vue b/resources/js/components/posts/editor/GoogleBusinessSettings.vue
index 108845ae7..144516bc9 100644
--- a/resources/js/components/posts/editor/GoogleBusinessSettings.vue
+++ b/resources/js/components/posts/editor/GoogleBusinessSettings.vue
@@ -21,6 +21,8 @@ interface SocialAccount {
 
 interface Props {
     socialAccount: SocialAccount | null;
+    /** This panel's position in the submitted `platforms` array — see findError. */
+    platformIndex: number;
     meta: Record<string, any>;
     disabled?: boolean;
     previewOnly?: boolean;
@@ -105,16 +107,17 @@ const offerCouponCode = offerField('coupon_code');
 const offerRedeemUrl = offerField('redeem_online_url');
 const offerTerms = offerField('terms_conditions');
 
-// Surface backend validation errors keyed by platform index
-// (`platforms.0.meta.*`). Suffix match avoids threading the index through props.
+// Backend validation errors are keyed `platforms.{index}.meta.*`. Matching the
+// full key keeps a location's error off the other locations' panels when a post
+// targets more than one Google Business Profile.
 const errors = usePageErrors();
-const findError = (suffix: string) => computed<string | undefined>(
-    () => Object.entries(errors.value).find(([key]) => key.endsWith(suffix))?.[1],
+const findError = (field: string) => computed<string | undefined>(
+    () => errors.value[`platforms.${props.platformIndex}.meta.${field}`],
 );
-const eventTitleError = findError('.meta.event.title');
-const eventStartDateError = findError('.meta.event.start_date');
-const eventEndDateError = findError('.meta.event.end_date');
-const ctaUrlError = findError('.meta.call_to_action.url');
+const eventTitleError = findError('event.title');
+const eventStartDateError = findError('event.start_date');
+const eventEndDateError = findError('event.end_date');
+const ctaUrlError = findError('call_to_action.url');
 </script>
 
 <template>

From 6c6b26143d62f8aed06c97b3ac88cf8476bcff04 Mon Sep 17 00:00:00 2001
From: Paulo Castellano <paulo@castellanos.llc>
Date: Tue, 11 Aug 2026 08:18:08 -0300
Subject: [PATCH 29/47] fix: forward the reconnect id through the Google
 Business OAuth callback

callback() never read session('social_reconnect_id'), so the reconnect
branch in select() could never fire even once a reconnect trigger exists.
Captures it and stores it in the google_business_oauth session payload, the
same way InstagramFacebookController already does.
---
 .../Auth/GoogleBusinessController.php         |  3 ++
 .../Social/GoogleBusinessControllerTest.php   | 29 +++++++++++++++++++
 2 files changed, 32 insertions(+)

diff --git a/app/Http/Controllers/Auth/GoogleBusinessController.php b/app/Http/Controllers/Auth/GoogleBusinessController.php
index 451eee403..cf3d0a38d 100644
--- a/app/Http/Controllers/Auth/GoogleBusinessController.php
+++ b/app/Http/Controllers/Auth/GoogleBusinessController.php
@@ -61,6 +61,8 @@ public function callback(Request $request): InertiaResponse|RedirectResponse
             return $this->popupCallback(false, __('accounts.popup_callback.workspace_not_found'), $this->platform->value);
         }
 
+        $reconnectId = session('social_reconnect_id');
+
         try {
             $socialUser = Socialite::driver($this->driver)->user();
 
@@ -82,6 +84,7 @@ public function callback(Request $request): InertiaResponse|RedirectResponse
                     'refresh_token' => $socialUser->refreshToken,
                     'expires_in' => $socialUser->expiresIn,
                     'user_id' => $socialUser->getId(),
+                    'reconnect_id' => $reconnectId,
                 ],
             ]);
 
diff --git a/tests/Feature/Social/GoogleBusinessControllerTest.php b/tests/Feature/Social/GoogleBusinessControllerTest.php
index 75ebaaa72..12f95281f 100644
--- a/tests/Feature/Social/GoogleBusinessControllerTest.php
+++ b/tests/Feature/Social/GoogleBusinessControllerTest.php
@@ -109,6 +109,35 @@
     expect(data_get(session('google_business_oauth'), 'access_token'))->toBe('access-token');
 });
 
+test('google business callback forwards the reconnect id into the picker session', function () {
+    session([
+        'social_connect_workspace' => $this->workspace->id,
+        'social_reconnect_id' => 'existing-account-id',
+    ]);
+
+    $socialiteUser = Mockery::mock(SocialiteUser::class);
+    $socialiteUser->shouldReceive('getId')->andReturn('gid-1');
+    $socialiteUser->token = 'access-token';
+    $socialiteUser->refreshToken = 'refresh-token';
+    $socialiteUser->expiresIn = 3600;
+
+    Socialite::shouldReceive('driver')->with('google-business')->andReturn(
+        Mockery::mock()->shouldReceive('user')->andReturn($socialiteUser)->getMock()
+    );
+
+    $this->mock(GoogleBusinessPublisher::class, function ($mock) {
+        $mock->shouldReceive('fetchLocations')->once()->andReturn([
+            ['id' => 'accounts/1/locations/2', 'account_name' => 'accounts/1', 'location_name' => 'locations/2', 'title' => 'Downtown Store', 'address' => null],
+            ['id' => 'accounts/1/locations/3', 'account_name' => 'accounts/1', 'location_name' => 'locations/3', 'title' => 'Uptown Store', 'address' => null],
+        ]);
+    });
+
+    $this->actingAs($this->user)->get(route('app.social.google-business.callback'))
+        ->assertRedirect(route('app.social.google-business.select-location'));
+
+    expect(data_get(session('google_business_oauth'), 'reconnect_id'))->toBe('existing-account-id');
+});
+
 test('google business callback fails when no locations are found', function () {
     session(['social_connect_workspace' => $this->workspace->id]);
 

From df3c56f5f3f4e2122cea779e3f115d47235a11b3 Mon Sep 17 00:00:00 2001
From: Paulo Castellano <paulo@castellanos.llc>
Date: Tue, 11 Aug 2026 08:18:59 -0300
Subject: [PATCH 30/47] refactor: share the Google Business CTA action-type
 list between editor and preview

The settings panel's option list and the preview's label lookup each
hand-wrote the same action types, so adding or renaming one meant editing
both. Both now read resources/js/lib/googleBusiness.ts.
---
 .../posts/editor/GoogleBusinessSettings.vue   | 15 ++---------
 .../posts/previews/GoogleBusinessPreview.vue  | 17 +++---------
 resources/js/lib/googleBusiness.ts            | 27 +++++++++++++++++++
 3 files changed, 32 insertions(+), 27 deletions(-)

diff --git a/resources/js/components/posts/editor/GoogleBusinessSettings.vue b/resources/js/components/posts/editor/GoogleBusinessSettings.vue
index 144516bc9..1e5473197 100644
--- a/resources/js/components/posts/editor/GoogleBusinessSettings.vue
+++ b/resources/js/components/posts/editor/GoogleBusinessSettings.vue
@@ -8,7 +8,7 @@ import { Input } from '@/components/ui/input';
 import { Textarea } from '@/components/ui/textarea';
 import { usePageErrors } from '@/composables/usePageErrors';
 import { getPlatformLogo } from '@/composables/usePlatformLogo';
-import { GOOGLE_BUSINESS_EVENT_TOPIC_TYPES } from '@/lib/googleBusiness';
+import { GOOGLE_BUSINESS_CTA_OPTIONS, GOOGLE_BUSINESS_EVENT_TOPIC_TYPES } from '@/lib/googleBusiness';
 
 interface SocialAccount {
     id: string;
@@ -45,17 +45,6 @@ const topicTypes = [
     { value: 'OFFER', labelKey: 'posts.form.google_business.topic_type.offer' },
 ] as const;
 
-const ctaOptions = [
-    { value: 'NONE', labelKey: 'posts.form.google_business.cta_none' },
-    { value: 'BOOK', labelKey: 'posts.form.google_business.cta.book' },
-    { value: 'ORDER', labelKey: 'posts.form.google_business.cta.order' },
-    { value: 'SHOP', labelKey: 'posts.form.google_business.cta.shop' },
-    { value: 'LEARN_MORE', labelKey: 'posts.form.google_business.cta.learn_more' },
-    { value: 'SIGN_UP', labelKey: 'posts.form.google_business.cta.sign_up' },
-    { value: 'GET_OFFER', labelKey: 'posts.form.google_business.cta.get_offer' },
-    { value: 'CALL', labelKey: 'posts.form.google_business.cta.call' },
-] as const;
-
 const topicType = computed<string>({
     get: () => props.meta?.topic_type || 'STANDARD',
     set: (value: string) => emit('update:meta', { ...props.meta, topic_type: value }),
@@ -214,7 +203,7 @@ const ctaUrlError = findError('call_to_action.url');
                     class="w-full rounded-lg border-2 border-foreground/30 bg-card px-3 py-2 text-sm font-medium text-foreground disabled:cursor-not-allowed disabled:opacity-50"
                     :disabled="disabled || previewOnly"
                 >
-                    <option v-for="option in ctaOptions" :key="option.value" :value="option.value">{{ $t(option.labelKey) }}</option>
+                    <option v-for="option in GOOGLE_BUSINESS_CTA_OPTIONS" :key="option.value" :value="option.value">{{ $t(option.labelKey) }}</option>
                 </select>
             </div>
 
diff --git a/resources/js/components/posts/previews/GoogleBusinessPreview.vue b/resources/js/components/posts/previews/GoogleBusinessPreview.vue
index 08de920cc..f230354e4 100644
--- a/resources/js/components/posts/previews/GoogleBusinessPreview.vue
+++ b/resources/js/components/posts/previews/GoogleBusinessPreview.vue
@@ -3,6 +3,7 @@ import { trans } from 'laravel-vue-i18n';
 import { computed } from 'vue';
 
 import { getInitials } from '@/composables/useInitials';
+import { googleBusinessCtaLabelKey } from '@/lib/googleBusiness';
 import type { MediaItem } from '@/types/media';
 
 interface SocialAccount {
@@ -24,21 +25,9 @@ interface Props {
 const props = defineProps<Props>();
 
 const ctaLabel = computed(() => {
-    const type = props.meta?.call_to_action?.action_type;
+    const labelKey = googleBusinessCtaLabelKey(props.meta?.call_to_action?.action_type);
 
-    if (!type || type === 'NONE') return null;
-
-    const labelKeys: Record<string, string> = {
-        BOOK: 'posts.form.google_business.cta.book',
-        ORDER: 'posts.form.google_business.cta.order',
-        SHOP: 'posts.form.google_business.cta.shop',
-        LEARN_MORE: 'posts.form.google_business.cta.learn_more',
-        SIGN_UP: 'posts.form.google_business.cta.sign_up',
-        GET_OFFER: 'posts.form.google_business.cta.get_offer',
-        CALL: 'posts.form.google_business.cta.call',
-    };
-
-    return labelKeys[type] ? trans(labelKeys[type]) : null;
+    return labelKey ? trans(labelKey) : null;
 });
 </script>
 
diff --git a/resources/js/lib/googleBusiness.ts b/resources/js/lib/googleBusiness.ts
index adc085b81..a5310493a 100644
--- a/resources/js/lib/googleBusiness.ts
+++ b/resources/js/lib/googleBusiness.ts
@@ -8,3 +8,30 @@
  * Mirrors PostPlatformMetaRules::GOOGLE_BUSINESS_EVENT_TOPIC_TYPES.
  */
 export const GOOGLE_BUSINESS_EVENT_TOPIC_TYPES: string[] = ['EVENT', 'OFFER'];
+
+export interface GoogleBusinessCtaOption {
+    value: string;
+    labelKey: string;
+}
+
+/**
+ * Call-to-action button types, in the order the editor lists them. `NONE` is the
+ * "no button" choice and has no preview label.
+ */
+export const GOOGLE_BUSINESS_CTA_OPTIONS: readonly GoogleBusinessCtaOption[] = [
+    { value: 'NONE', labelKey: 'posts.form.google_business.cta_none' },
+    { value: 'BOOK', labelKey: 'posts.form.google_business.cta.book' },
+    { value: 'ORDER', labelKey: 'posts.form.google_business.cta.order' },
+    { value: 'SHOP', labelKey: 'posts.form.google_business.cta.shop' },
+    { value: 'LEARN_MORE', labelKey: 'posts.form.google_business.cta.learn_more' },
+    { value: 'SIGN_UP', labelKey: 'posts.form.google_business.cta.sign_up' },
+    { value: 'GET_OFFER', labelKey: 'posts.form.google_business.cta.get_offer' },
+    { value: 'CALL', labelKey: 'posts.form.google_business.cta.call' },
+];
+
+/** The i18n key for a CTA action type's button label, or null when it has none. */
+export const googleBusinessCtaLabelKey = (actionType?: string | null): string | null => {
+    if (!actionType || actionType === 'NONE') return null;
+
+    return GOOGLE_BUSINESS_CTA_OPTIONS.find((option) => option.value === actionType)?.labelKey ?? null;
+};

From 02040a59fe4ac95310df7f79049b7b4e5a189a0b Mon Sep 17 00:00:00 2001
From: Paulo Castellano <paulo@castellanos.llc>
Date: Tue, 11 Aug 2026 08:19:25 -0300
Subject: [PATCH 31/47] chore: drop the unused
 GoogleBusinessPublisher::getLocations()

It had no callers: the connect flow has no SocialAccount yet, so the
controller always calls fetchLocations() with the raw access token.
---
 app/Services/Social/GoogleBusinessPublisher.php | 13 -------------
 1 file changed, 13 deletions(-)

diff --git a/app/Services/Social/GoogleBusinessPublisher.php b/app/Services/Social/GoogleBusinessPublisher.php
index 81c217427..e24d616db 100644
--- a/app/Services/Social/GoogleBusinessPublisher.php
+++ b/app/Services/Social/GoogleBusinessPublisher.php
@@ -9,7 +9,6 @@
 use App\Exceptions\Social\ErrorCategory;
 use App\Exceptions\Social\GoogleBusinessPublishException;
 use App\Models\PostPlatform;
-use App\Models\SocialAccount;
 use App\Services\Social\Concerns\HasSocialHttpClient;
 use Carbon\CarbonImmutable;
 use Illuminate\Http\Client\Response;
@@ -94,18 +93,6 @@ public function fetchLocations(string $accessToken): array
         return $locations;
     }
 
-    /**
-     * @return list<array{id: string, account_name: string, location_name: string, title: string, address: ?string}>
-     */
-    public function getLocations(SocialAccount $account): array
-    {
-        if ($account->needsProactiveTokenRefresh()) {
-            app(ConnectionVerifier::class)->refreshToken($account);
-        }
-
-        return $this->fetchLocations($account->access_token);
-    }
-
     /**
      * @return array<string, mixed> The Local Post request body.
      */

From 49c156e8ca6d2ea0373282844c5db488a0791c1d Mon Sep 17 00:00:00 2001
From: Paulo Castellano <paulo@castellanos.llc>
Date: Tue, 11 Aug 2026 08:52:26 -0300
Subject: [PATCH 32/47] fix: harden and de-duplicate the Google Business
 connect flow

- selectLocation() now checks manageAccounts like callback()/select() do
- the locations fetched during callback() are cached in the OAuth session payload, so a multi-location connect hits Google once instead of three times
- select()'s inline validation moves to a dedicated FormRequest
---
 .../Auth/GoogleBusinessController.php         | 16 ++--
 .../SelectGoogleBusinessLocationRequest.php   | 25 ++++++
 .../Social/GoogleBusinessControllerTest.php   | 83 +++++++++++++++----
 3 files changed, 99 insertions(+), 25 deletions(-)
 create mode 100644 app/Http/Requests/Auth/SelectGoogleBusinessLocationRequest.php

diff --git a/app/Http/Controllers/Auth/GoogleBusinessController.php b/app/Http/Controllers/Auth/GoogleBusinessController.php
index cf3d0a38d..6332a94eb 100644
--- a/app/Http/Controllers/Auth/GoogleBusinessController.php
+++ b/app/Http/Controllers/Auth/GoogleBusinessController.php
@@ -7,6 +7,7 @@
 use App\Enums\SocialAccount\Platform as SocialPlatform;
 use App\Enums\SocialAccount\Status;
 use App\Exceptions\SocialAccount\NetworkAlreadyConnectedException;
+use App\Http\Requests\Auth\SelectGoogleBusinessLocationRequest;
 use App\Models\Workspace;
 use App\Services\Social\GoogleBusinessPublisher;
 use Illuminate\Http\RedirectResponse;
@@ -85,6 +86,7 @@ public function callback(Request $request): InertiaResponse|RedirectResponse
                     'expires_in' => $socialUser->expiresIn,
                     'user_id' => $socialUser->getId(),
                     'reconnect_id' => $reconnectId,
+                    'locations' => $locations,
                 ],
             ]);
 
@@ -112,11 +114,11 @@ public function selectLocation(Request $request): InertiaResponse
 
         $workspace = Workspace::find($workspaceId);
 
-        if (! $workspace) {
+        if (! $workspace || ! $request->user()->can('manageAccounts', $workspace)) {
             return $this->popupCallback(false, __('accounts.popup_callback.workspace_not_found'), $this->platform->value);
         }
 
-        $locations = $this->publisher->fetchLocations(data_get($oauthData, 'access_token'));
+        $locations = data_get($oauthData, 'locations', []);
 
         if (empty($locations)) {
             $this->forgetSocialConnectSession();
@@ -131,12 +133,8 @@ public function selectLocation(Request $request): InertiaResponse
         ]);
     }
 
-    public function select(Request $request): InertiaResponse
+    public function select(SelectGoogleBusinessLocationRequest $request): InertiaResponse
     {
-        $request->validate([
-            'location_id' => 'required|string',
-        ]);
-
         $oauthData = session('google_business_oauth');
         $workspaceId = session('social_connect_workspace');
 
@@ -151,8 +149,8 @@ public function select(Request $request): InertiaResponse
         }
 
         try {
-            $locations = $this->publisher->fetchLocations(data_get($oauthData, 'access_token'));
-            $selectedLocation = collect($locations)->firstWhere('id', $request->location_id);
+            $selectedLocation = collect(data_get($oauthData, 'locations'))
+                ->firstWhere('id', $request->validated('location_id'));
 
             if (! $selectedLocation) {
                 return $this->popupCallback(false, __('accounts.popup_callback.location_not_found'), $this->platform->value);
diff --git a/app/Http/Requests/Auth/SelectGoogleBusinessLocationRequest.php b/app/Http/Requests/Auth/SelectGoogleBusinessLocationRequest.php
new file mode 100644
index 000000000..2578b5d3b
--- /dev/null
+++ b/app/Http/Requests/Auth/SelectGoogleBusinessLocationRequest.php
@@ -0,0 +1,25 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Http\Requests\Auth;
+
+use Illuminate\Foundation\Http\FormRequest;
+
+class SelectGoogleBusinessLocationRequest extends FormRequest
+{
+    public function authorize(): bool
+    {
+        return true;
+    }
+
+    /**
+     * @return array<string, mixed>
+     */
+    public function rules(): array
+    {
+        return [
+            'location_id' => ['required', 'string'],
+        ];
+    }
+}
diff --git a/tests/Feature/Social/GoogleBusinessControllerTest.php b/tests/Feature/Social/GoogleBusinessControllerTest.php
index 12f95281f..3aed1ff99 100644
--- a/tests/Feature/Social/GoogleBusinessControllerTest.php
+++ b/tests/Feature/Social/GoogleBusinessControllerTest.php
@@ -107,6 +107,7 @@
     expect($this->workspace->socialAccounts()->where('platform', Platform::GoogleBusiness)->exists())->toBeFalse();
     expect(session('google_business_oauth'))->not->toBeNull();
     expect(data_get(session('google_business_oauth'), 'access_token'))->toBe('access-token');
+    expect(data_get(session('google_business_oauth'), 'locations'))->toHaveCount(2);
 });
 
 test('google business callback forwards the reconnect id into the picker session', function () {
@@ -216,6 +217,61 @@
     );
 });
 
+test('select location renders the picker from the session without refetching locations', function () {
+    session([
+        'social_connect_workspace' => $this->workspace->id,
+        'google_business_oauth' => [
+            'access_token' => 'access-token',
+            'refresh_token' => 'refresh-token',
+            'expires_in' => 3600,
+            'user_id' => 'gid-1',
+            'locations' => [
+                ['id' => 'accounts/1/locations/2', 'account_name' => 'accounts/1', 'location_name' => 'locations/2', 'title' => 'Downtown Store', 'address' => null],
+                ['id' => 'accounts/1/locations/3', 'account_name' => 'accounts/1', 'location_name' => 'locations/3', 'title' => 'Uptown Store', 'address' => null],
+            ],
+        ],
+    ]);
+
+    $this->mock(GoogleBusinessPublisher::class, function ($mock) {
+        $mock->shouldNotReceive('fetchLocations');
+    });
+
+    $response = $this->actingAs($this->user)->get(route('app.social.google-business.select-location'));
+
+    $response->assertOk();
+    $response->assertInertia(fn (AssertableInertia $page) => $page
+        ->component('accounts/GoogleBusinessLocationSelect')
+        ->has('locations', 2)
+    );
+});
+
+test('select location fails for a user who cannot manage the workspace accounts', function () {
+    $outsider = User::factory()->create();
+
+    session([
+        'social_connect_workspace' => $this->workspace->id,
+        'google_business_oauth' => [
+            'access_token' => 'access-token',
+            'refresh_token' => 'refresh-token',
+            'expires_in' => 3600,
+            'user_id' => 'gid-1',
+            'locations' => [
+                ['id' => 'accounts/1/locations/2', 'account_name' => 'accounts/1', 'location_name' => 'locations/2', 'title' => 'Downtown Store', 'address' => null],
+                ['id' => 'accounts/1/locations/3', 'account_name' => 'accounts/1', 'location_name' => 'locations/3', 'title' => 'Uptown Store', 'address' => null],
+            ],
+        ],
+    ]);
+
+    $response = $this->actingAs($outsider)->get(route('app.social.google-business.select-location'));
+
+    $response->assertOk();
+    $response->assertInertia(fn (AssertableInertia $page) => $page
+        ->component('accounts/PopupCallback')
+        ->where('success', false)
+        ->where('message', __('accounts.popup_callback.workspace_not_found'))
+    );
+});
+
 test('select creates the social account for the chosen location', function () {
     session([
         'social_connect_workspace' => $this->workspace->id,
@@ -224,14 +280,15 @@
             'refresh_token' => 'refresh-token',
             'expires_in' => 3600,
             'user_id' => 'gid-1',
+            'locations' => [
+                ['id' => 'accounts/1/locations/2', 'account_name' => 'accounts/1', 'location_name' => 'locations/2', 'title' => 'Downtown Store', 'address' => null],
+                ['id' => 'accounts/1/locations/3', 'account_name' => 'accounts/1', 'location_name' => 'locations/3', 'title' => 'Uptown Store', 'address' => null],
+            ],
         ],
     ]);
 
     $this->mock(GoogleBusinessPublisher::class, function ($mock) {
-        $mock->shouldReceive('fetchLocations')->once()->with('access-token')->andReturn([
-            ['id' => 'accounts/1/locations/2', 'account_name' => 'accounts/1', 'location_name' => 'locations/2', 'title' => 'Downtown Store', 'address' => null],
-            ['id' => 'accounts/1/locations/3', 'account_name' => 'accounts/1', 'location_name' => 'locations/3', 'title' => 'Uptown Store', 'address' => null],
-        ]);
+        $mock->shouldNotReceive('fetchLocations');
     });
 
     $response = $this->actingAs($this->user)
@@ -258,15 +315,12 @@
             'refresh_token' => 'refresh-token',
             'expires_in' => 3600,
             'user_id' => 'gid-1',
+            'locations' => [
+                ['id' => 'accounts/1/locations/2', 'account_name' => 'accounts/1', 'location_name' => 'locations/2', 'title' => 'Downtown Store', 'address' => null],
+            ],
         ],
     ]);
 
-    $this->mock(GoogleBusinessPublisher::class, function ($mock) {
-        $mock->shouldReceive('fetchLocations')->once()->andReturn([
-            ['id' => 'accounts/1/locations/2', 'account_name' => 'accounts/1', 'location_name' => 'locations/2', 'title' => 'Downtown Store', 'address' => null],
-        ]);
-    });
-
     $response = $this->actingAs($this->user)
         ->post(route('app.social.google-business.select'), ['location_id' => 'accounts/1/locations/nope']);
 
@@ -308,15 +362,12 @@
             'expires_in' => 3600,
             'user_id' => 'gid-1',
             'reconnect_id' => $existingAccount->id,
+            'locations' => [
+                ['id' => 'accounts/1/locations/2', 'account_name' => 'accounts/1', 'location_name' => 'locations/2', 'title' => 'Downtown Store', 'address' => null],
+            ],
         ],
     ]);
 
-    $this->mock(GoogleBusinessPublisher::class, function ($mock) {
-        $mock->shouldReceive('fetchLocations')->once()->with('new-access-token')->andReturn([
-            ['id' => 'accounts/1/locations/2', 'account_name' => 'accounts/1', 'location_name' => 'locations/2', 'title' => 'Downtown Store', 'address' => null],
-        ]);
-    });
-
     $response = $this->actingAs($this->user)
         ->post(route('app.social.google-business.select'), ['location_id' => 'accounts/1/locations/2']);
 

From a4de84e5225de2a8e86ac3cc8a106069e7f3f883 Mon Sep 17 00:00:00 2001
From: Paulo Castellano <paulo@castellanos.llc>
Date: Tue, 11 Aug 2026 08:53:07 -0300
Subject: [PATCH 33/47] fix: treat an explicitly null Google Business CTA
 action type as no CTA

Also disables the topic-type pills in preview-only mode, like every other input in the panel.
---
 app/Support/PostPlatformMetaRules.php                  |  2 +-
 .../components/posts/editor/GoogleBusinessSettings.vue |  2 +-
 tests/Unit/PostPlatformMetaRulesTest.php               | 10 ++++++++++
 3 files changed, 12 insertions(+), 2 deletions(-)

diff --git a/app/Support/PostPlatformMetaRules.php b/app/Support/PostPlatformMetaRules.php
index 384dd9975..2c7a52db3 100644
--- a/app/Support/PostPlatformMetaRules.php
+++ b/app/Support/PostPlatformMetaRules.php
@@ -202,7 +202,7 @@ private static function requiredMetaViolation(?Platform $platform, mixed $meta):
                 && in_array(data_get($meta, 'topic_type', 'STANDARD'), self::GOOGLE_BUSINESS_EVENT_TOPIC_TYPES, true)
                 && blank(data_get($meta, 'event.end_date')) => ['event.end_date', trans('posts.form.google_business.event_end_date_required')],
             $platform === Platform::GoogleBusiness
-                && ! in_array(data_get($meta, 'call_to_action.action_type', 'NONE'), ['NONE', 'CALL'], true)
+                && ! in_array(data_get($meta, 'call_to_action.action_type') ?? 'NONE', ['NONE', 'CALL'], true)
                 && blank(data_get($meta, 'call_to_action.url')) => ['call_to_action.url', trans('posts.form.google_business.cta_url_required')],
             default => null,
         };
diff --git a/resources/js/components/posts/editor/GoogleBusinessSettings.vue b/resources/js/components/posts/editor/GoogleBusinessSettings.vue
index 1e5473197..9a16fc025 100644
--- a/resources/js/components/posts/editor/GoogleBusinessSettings.vue
+++ b/resources/js/components/posts/editor/GoogleBusinessSettings.vue
@@ -147,7 +147,7 @@ const ctaUrlError = findError('call_to_action.url');
                         :class="topicType === type.value
                             ? 'border-foreground bg-violet-100 text-foreground shadow-2xs'
                             : 'border-foreground/30 text-foreground/70 hover:border-foreground hover:text-foreground'"
-                        :disabled="disabled"
+                        :disabled="disabled || previewOnly"
                         @click="topicType = type.value"
                     >
                         {{ $t(type.labelKey) }}
diff --git a/tests/Unit/PostPlatformMetaRulesTest.php b/tests/Unit/PostPlatformMetaRulesTest.php
index 4299b4cfb..88031fabd 100644
--- a/tests/Unit/PostPlatformMetaRulesTest.php
+++ b/tests/Unit/PostPlatformMetaRulesTest.php
@@ -134,6 +134,16 @@
     expect($violation)->toBeNull();
 });
 
+test('google business call_to_action with an explicitly null action_type has no url violation', function () {
+    $violation = (new ReflectionMethod(PostPlatformMetaRules::class, 'requiredMetaViolation'))
+        ->invoke(null, Platform::GoogleBusiness, [
+            'topic_type' => 'STANDARD',
+            'call_to_action' => ['action_type' => null],
+        ]);
+
+    expect($violation)->toBeNull();
+});
+
 test('google business call_to_action with url-needing action type and a url has no violation', function () {
     $violation = (new ReflectionMethod(PostPlatformMetaRules::class, 'requiredMetaViolation'))
         ->invoke(null, Platform::GoogleBusiness, [

From b221b7a9aeaf5cb1e7e6740201dd13452af0a0c7 Mon Sep 17 00:00:00 2001
From: Paulo Castellano <paulo@castellanos.llc>
Date: Tue, 11 Aug 2026 08:53:44 -0300
Subject: [PATCH 34/47] perf: cache Google Business Profile location metrics
 like the sibling analytics services

---
 .../Social/GoogleBusinessAnalytics.php        |  9 +++++++
 .../Social/GoogleBusinessAnalyticsTest.php    | 24 +++++++++++++++++++
 2 files changed, 33 insertions(+)

diff --git a/app/Services/Social/GoogleBusinessAnalytics.php b/app/Services/Social/GoogleBusinessAnalytics.php
index 3b5f7ddc9..a2a037f66 100644
--- a/app/Services/Social/GoogleBusinessAnalytics.php
+++ b/app/Services/Social/GoogleBusinessAnalytics.php
@@ -7,6 +7,7 @@
 use App\Models\SocialAccount;
 use App\Services\Social\Concerns\HasSocialHttpClient;
 use Carbon\CarbonInterface;
+use Illuminate\Support\Facades\Cache;
 use Illuminate\Support\Facades\Log;
 
 class GoogleBusinessAnalytics
@@ -34,6 +35,14 @@ public function getMetrics(SocialAccount $account, ?CarbonInterface $since = nul
         $since ??= now()->subDays(7);
         $until ??= now();
 
+        $cacheKey = "analytics:google_business:{$account->id}:{$since->format('Y-m-d')}:{$until->format('Y-m-d')}";
+        $cacheTtl = app()->isProduction() ? 3600 : 1;
+
+        return Cache::remember($cacheKey, $cacheTtl, fn () => $this->fetchMetricsFromApi($account, $since, $until));
+    }
+
+    private function fetchMetricsFromApi(SocialAccount $account, CarbonInterface $since, CarbonInterface $until): array
+    {
         if ($account->needsProactiveTokenRefresh()) {
             app(ConnectionVerifier::class)->refreshToken($account);
         }
diff --git a/tests/Feature/Services/Social/GoogleBusinessAnalyticsTest.php b/tests/Feature/Services/Social/GoogleBusinessAnalyticsTest.php
index 6e06c196c..b9aa87842 100644
--- a/tests/Feature/Services/Social/GoogleBusinessAnalyticsTest.php
+++ b/tests/Feature/Services/Social/GoogleBusinessAnalyticsTest.php
@@ -132,6 +132,30 @@
         ->and(collect($metrics)->firstWhere('label', __('analytics.metrics.website_clicks'))['value'])->toBe(7);
 });
 
+test('caches the metrics so a repeated call within the window does not hit the api again', function () {
+    Http::fake([
+        config('trypost.platforms.google_business.performance_api').'/*' => Http::response([
+            'multiDailyMetricTimeSeries' => [
+                [
+                    'dailyMetricTimeSeries' => [
+                        [
+                            'dailyMetric' => 'WEBSITE_CLICKS',
+                            'timeSeries' => ['datedValues' => [['value' => '9']]],
+                        ],
+                    ],
+                ],
+            ],
+        ], 200),
+    ]);
+
+    $first = $this->analytics->getMetrics($this->socialAccount);
+    $second = $this->analytics->getMetrics($this->socialAccount);
+
+    expect($second)->toBe($first);
+
+    Http::assertSentCount(1);
+});
+
 test('returns empty array on api failure', function () {
     Http::fake([
         config('trypost.platforms.google_business.performance_api').'/*' => Http::response([], 500),

From 515d7da4379f4cb491e7fc04d31fa13984d067f9 Mon Sep 17 00:00:00 2001
From: Paulo Castellano <paulo@castellanos.llc>
Date: Tue, 11 Aug 2026 08:54:32 -0300
Subject: [PATCH 35/47] refactor: share the Google Business dashboard URL
 builder between the model and publisher

---
 app/Models/SocialAccount.php                  |  3 ++-
 .../Social/GoogleBusinessPublisher.php        | 14 ++--------
 app/Support/GoogleBusinessResourceName.php    | 26 +++++++++++++++++++
 3 files changed, 30 insertions(+), 13 deletions(-)
 create mode 100644 app/Support/GoogleBusinessResourceName.php

diff --git a/app/Models/SocialAccount.php b/app/Models/SocialAccount.php
index 06f74ba8a..a0815d49c 100644
--- a/app/Models/SocialAccount.php
+++ b/app/Models/SocialAccount.php
@@ -11,6 +11,7 @@
 use App\Jobs\SendNotification;
 use App\Mail\AccountDisconnected;
 use App\Observers\SocialAccountObserver;
+use App\Support\GoogleBusinessResourceName;
 use Database\Factories\SocialAccountFactory;
 use Illuminate\Database\Eloquent\Attributes\ObservedBy;
 use Illuminate\Database\Eloquent\Builder;
@@ -147,7 +148,7 @@ protected function profileUrl(): Attribute
                         : null,
                     SocialPlatform::Telegram => $username ? "https://t.me/{$username}" : null,
                     SocialPlatform::GoogleBusiness => data_get($this->meta, 'location_id')
-                        ? 'https://business.google.com/locations/'.last(explode('/', (string) data_get($this->meta, 'location_id')))
+                        ? GoogleBusinessResourceName::dashboardUrl((string) data_get($this->meta, 'location_id'))
                         : null,
                     default => null,
                 };
diff --git a/app/Services/Social/GoogleBusinessPublisher.php b/app/Services/Social/GoogleBusinessPublisher.php
index e24d616db..1ee7ee7f8 100644
--- a/app/Services/Social/GoogleBusinessPublisher.php
+++ b/app/Services/Social/GoogleBusinessPublisher.php
@@ -10,6 +10,7 @@
 use App\Exceptions\Social\GoogleBusinessPublishException;
 use App\Models\PostPlatform;
 use App\Services\Social\Concerns\HasSocialHttpClient;
+use App\Support\GoogleBusinessResourceName;
 use Carbon\CarbonImmutable;
 use Illuminate\Http\Client\Response;
 use Illuminate\Support\Facades\Log;
@@ -71,7 +72,7 @@ public function publish(PostPlatform $postPlatform): array
 
         return [
             'id' => $postName,
-            'url' => 'https://business.google.com/locations/'.$this->shortLocationId($locationId),
+            'url' => GoogleBusinessResourceName::dashboardUrl($locationId),
         ];
     }
 
@@ -197,17 +198,6 @@ private function formatTime(string $time): array
         return ['hours' => (int) $carbon->format('G'), 'minutes' => (int) $carbon->format('i'), 'seconds' => 0, 'nanos' => 0];
     }
 
-    /**
-     * Full `accounts/{id}/locations/{id}` resource name → the bare numeric id used
-     * in the dashboard link, matching postiz's synthesized URL shape.
-     */
-    private function shortLocationId(string $locationId): string
-    {
-        $segments = explode('/', $locationId);
-
-        return end($segments);
-    }
-
     /**
      * @return list<string> Full "accounts/{id}" resource names.
      */
diff --git a/app/Support/GoogleBusinessResourceName.php b/app/Support/GoogleBusinessResourceName.php
new file mode 100644
index 000000000..b6d55e62c
--- /dev/null
+++ b/app/Support/GoogleBusinessResourceName.php
@@ -0,0 +1,26 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Support;
+
+/**
+ * Google Business Profile identifies a location by its full
+ * `accounts/{account}/locations/{location}` resource name, while the Business
+ * Profile dashboard links by the bare trailing location id. Both the publisher
+ * (post URLs) and the social account model (profile URL) need that same link,
+ * so the conversion lives here once.
+ */
+class GoogleBusinessResourceName
+{
+    /**
+     * The Business Profile dashboard URL for a location resource name, matching
+     * postiz's synthesized URL shape.
+     */
+    public static function dashboardUrl(string $resourceName): string
+    {
+        $segments = explode('/', $resourceName);
+
+        return 'https://business.google.com/locations/'.end($segments);
+    }
+}

From 6d9261ccd3d6fbd8fe0494bc532ca20564278bc2 Mon Sep 17 00:00:00 2001
From: Paulo Castellano <paulo@castellanos.llc>
Date: Tue, 11 Aug 2026 08:56:13 -0300
Subject: [PATCH 36/47] feat: add the Google Business Profile analytics
 dashboard panel

---
 .../analytics/GoogleBusinessAnalytics.vue     | 61 +++++++++++++++++++
 resources/js/pages/analytics/Index.vue        |  8 +++
 2 files changed, 69 insertions(+)
 create mode 100644 resources/js/components/analytics/GoogleBusinessAnalytics.vue

diff --git a/resources/js/components/analytics/GoogleBusinessAnalytics.vue b/resources/js/components/analytics/GoogleBusinessAnalytics.vue
new file mode 100644
index 000000000..943e0480f
--- /dev/null
+++ b/resources/js/components/analytics/GoogleBusinessAnalytics.vue
@@ -0,0 +1,61 @@
+<script setup lang="ts">
+import { useHttp } from '@inertiajs/vue3';
+import { trans } from 'laravel-vue-i18n';
+import { onMounted, ref, watch } from 'vue';
+
+import MetricsGrid from '@/components/analytics/MetricsGrid.vue';
+import dayjs from '@/dayjs';
+import { show as showAnalytics } from '@/routes/app/analytics';
+
+interface MetricItem {
+    label: string;
+    value: number;
+}
+
+const props = defineProps<{
+    accountId: string;
+    dateRange: { start: Date; end: Date };
+}>();
+
+const metrics = ref<MetricItem[]>([]);
+const isLoading = ref(false);
+
+const http = useHttp<Record<string, never>, { metrics: MetricItem[] }>({});
+
+const fetchMetrics = async () => {
+    isLoading.value = true;
+    metrics.value = [];
+
+    try {
+        const response = await http.get(showAnalytics.url(props.accountId, {
+            query: {
+                since: dayjs(props.dateRange.start).format('YYYY-MM-DD'),
+                until: dayjs(props.dateRange.end).format('YYYY-MM-DD'),
+            },
+        }));
+        metrics.value = response?.metrics || [];
+    } catch {
+        metrics.value = [];
+    } finally {
+        isLoading.value = false;
+    }
+};
+
+watch(() => props.accountId, () => {
+    fetchMetrics();
+});
+
+watch(() => props.dateRange, () => {
+    fetchMetrics();
+}, { deep: true });
+
+onMounted(() => {
+    fetchMetrics();
+});
+
+defineExpose({ supportsDateRange: true });
+</script>
+
+<template>
+    <MetricsGrid :metrics="metrics" :loading="isLoading" :empty-label="trans('analytics.no_data')" />
+</template>
diff --git a/resources/js/pages/analytics/Index.vue b/resources/js/pages/analytics/Index.vue
index 712b00254..917fe7587 100644
--- a/resources/js/pages/analytics/Index.vue
+++ b/resources/js/pages/analytics/Index.vue
@@ -5,6 +5,7 @@ import { computed, ref } from 'vue';
 
 import AnalyticsAccountSelector from '@/components/analytics/AnalyticsAccountSelector.vue';
 import FacebookAnalytics from '@/components/analytics/FacebookAnalytics.vue';
+import GoogleBusinessAnalytics from '@/components/analytics/GoogleBusinessAnalytics.vue';
 import InstagramAnalytics from '@/components/analytics/InstagramAnalytics.vue';
 import LinkedInPageAnalytics from '@/components/analytics/LinkedInPageAnalytics.vue';
 import PinterestAnalytics from '@/components/analytics/PinterestAnalytics.vue';
@@ -45,6 +46,7 @@ const platformSupportsDateRange = computed(() => {
         'threads',
         'x',
         'linkedin-page',
+        'google_business',
     ].includes(selectedAccount.value.platform);
 });
 </script>
@@ -136,6 +138,12 @@ const platformSupportsDateRange = computed(() => {
                 :date-range="dateRange"
             />
 
+            <GoogleBusinessAnalytics
+                v-else-if="selectedAccount?.platform === 'google_business'"
+                :account-id="selectedAccountId"
+                :date-range="dateRange"
+            />
+
             <TelegramAnalytics
                 v-else-if="selectedAccount?.platform === 'telegram'"
                 :account-id="selectedAccountId"

From 06a21a3d782db31110aaf5948c5095171130e30f Mon Sep 17 00:00:00 2001
From: Paulo Castellano <paulo@castellanos.llc>
Date: Tue, 11 Aug 2026 09:19:32 -0300
Subject: [PATCH 37/47] fix: render the Google Business Profile tile and its
 default content type

The connect grid had no google_business entry in its platform theme map, so the
tile fell back to an empty image, and the automation Generate node had no case
for the platform, leaving its content type blank.
---
 resources/js/components/accounts/NetworkConnectGrid.vue      | 5 +++++
 .../js/components/automations/config/GenerateNodeConfig.vue  | 2 ++
 2 files changed, 7 insertions(+)

diff --git a/resources/js/components/accounts/NetworkConnectGrid.vue b/resources/js/components/accounts/NetworkConnectGrid.vue
index 314beabd4..861b17b6c 100644
--- a/resources/js/components/accounts/NetworkConnectGrid.vue
+++ b/resources/js/components/accounts/NetworkConnectGrid.vue
@@ -121,6 +121,11 @@ const platformTheme: Record<
         rotate: 'rotate-1',
         image: '/images/accounts/discord.png',
     },
+    google_business: {
+        bg: 'bg-blue-100',
+        rotate: 'rotate-2',
+        image: '/images/accounts/google_business.png',
+    },
 };
 
 const themeFor = (value: string) =>
diff --git a/resources/js/components/automations/config/GenerateNodeConfig.vue b/resources/js/components/automations/config/GenerateNodeConfig.vue
index b3311ed63..a5ca08d71 100644
--- a/resources/js/components/automations/config/GenerateNodeConfig.vue
+++ b/resources/js/components/automations/config/GenerateNodeConfig.vue
@@ -127,6 +127,8 @@ const defaultContentTypeFor = (platform: string): string => {
             return ContentType.BlueskyPost;
         case Platform.Mastodon:
             return ContentType.MastodonPost;
+        case Platform.GoogleBusiness:
+            return ContentType.GoogleBusinessPost;
         default:
             return '';
     }

From 3f1d5a48735d6088f753ac2cde1b1264d7e33f86 Mon Sep 17 00:00:00 2001
From: Paulo Castellano <paulo@castellanos.llc>
Date: Tue, 11 Aug 2026 09:19:55 -0300
Subject: [PATCH 38/47] fix: treat an explicitly null Google Business topic
 type as STANDARD

data_get()'s default only applies when the key is missing, so a stored
'topic_type' => null published an empty topicType. Same bug class as the CTA
action type fixed earlier. Also hoists the repeated EVENT/OFFER guard out of
the match(true) arms and points the publisher at the shared topic-type
constant instead of a literal copy of the list.
---
 app/Services/Social/GoogleBusinessPublisher.php     |  5 +++--
 app/Support/PostPlatformMetaRules.php               | 12 ++++++------
 .../Services/Social/GoogleBusinessPublisherTest.php | 13 +++++++++++++
 tests/Unit/PostPlatformMetaRulesTest.php            | 10 ++++++++++
 4 files changed, 32 insertions(+), 8 deletions(-)

diff --git a/app/Services/Social/GoogleBusinessPublisher.php b/app/Services/Social/GoogleBusinessPublisher.php
index 1ee7ee7f8..3ddabc877 100644
--- a/app/Services/Social/GoogleBusinessPublisher.php
+++ b/app/Services/Social/GoogleBusinessPublisher.php
@@ -11,6 +11,7 @@
 use App\Models\PostPlatform;
 use App\Services\Social\Concerns\HasSocialHttpClient;
 use App\Support\GoogleBusinessResourceName;
+use App\Support\PostPlatformMetaRules;
 use Carbon\CarbonImmutable;
 use Illuminate\Http\Client\Response;
 use Illuminate\Support\Facades\Log;
@@ -100,7 +101,7 @@ public function fetchLocations(string $accessToken): array
     private function buildPayload(PostPlatform $postPlatform, string $content): array
     {
         $languageCode = $postPlatform->post->workspace->content_language ?? ContentLanguage::DEFAULT->value;
-        $topicType = (string) data_get($postPlatform->meta, 'topic_type', 'STANDARD');
+        $topicType = (string) (data_get($postPlatform->meta, 'topic_type') ?? 'STANDARD');
 
         $payload = [
             'languageCode' => $languageCode,
@@ -129,7 +130,7 @@ private function buildPayload(PostPlatform $postPlatform, string $content): arra
             ]];
         }
 
-        if (in_array($topicType, ['EVENT', 'OFFER'], true)) {
+        if (in_array($topicType, PostPlatformMetaRules::GOOGLE_BUSINESS_EVENT_TOPIC_TYPES, true)) {
             $payload['event'] = $this->buildEvent($postPlatform);
         }
 
diff --git a/app/Support/PostPlatformMetaRules.php b/app/Support/PostPlatformMetaRules.php
index 2c7a52db3..e286286f8 100644
--- a/app/Support/PostPlatformMetaRules.php
+++ b/app/Support/PostPlatformMetaRules.php
@@ -188,18 +188,18 @@ public static function assertStoredPostPublishable(Post $post): void
      */
     private static function requiredMetaViolation(?Platform $platform, mixed $meta): ?array
     {
+        $needsGoogleBusinessEvent = $platform === Platform::GoogleBusiness
+            && in_array(data_get($meta, 'topic_type') ?? 'STANDARD', self::GOOGLE_BUSINESS_EVENT_TOPIC_TYPES, true);
+
         return match (true) {
             $platform === Platform::TikTok && blank(data_get($meta, 'privacy_level')) => ['privacy_level', trans('posts.form.tiktok.privacy_required')],
             $platform === Platform::Pinterest && blank(data_get($meta, 'board_id')) => ['board_id', trans('posts.form.pinterest.board_required')],
             $platform === Platform::Discord && blank(data_get($meta, 'channel_id')) => ['channel_id', trans('posts.form.discord.channel_required')],
-            $platform === Platform::GoogleBusiness
-                && in_array(data_get($meta, 'topic_type', 'STANDARD'), self::GOOGLE_BUSINESS_EVENT_TOPIC_TYPES, true)
+            $needsGoogleBusinessEvent
                 && blank(data_get($meta, 'event.title')) => ['event.title', trans('posts.form.google_business.event_title_required')],
-            $platform === Platform::GoogleBusiness
-                && in_array(data_get($meta, 'topic_type', 'STANDARD'), self::GOOGLE_BUSINESS_EVENT_TOPIC_TYPES, true)
+            $needsGoogleBusinessEvent
                 && blank(data_get($meta, 'event.start_date')) => ['event.start_date', trans('posts.form.google_business.event_start_date_required')],
-            $platform === Platform::GoogleBusiness
-                && in_array(data_get($meta, 'topic_type', 'STANDARD'), self::GOOGLE_BUSINESS_EVENT_TOPIC_TYPES, true)
+            $needsGoogleBusinessEvent
                 && blank(data_get($meta, 'event.end_date')) => ['event.end_date', trans('posts.form.google_business.event_end_date_required')],
             $platform === Platform::GoogleBusiness
                 && ! in_array(data_get($meta, 'call_to_action.action_type') ?? 'NONE', ['NONE', 'CALL'], true)
diff --git a/tests/Feature/Services/Social/GoogleBusinessPublisherTest.php b/tests/Feature/Services/Social/GoogleBusinessPublisherTest.php
index 1d4ccf9fd..eaaafb518 100644
--- a/tests/Feature/Services/Social/GoogleBusinessPublisherTest.php
+++ b/tests/Feature/Services/Social/GoogleBusinessPublisherTest.php
@@ -61,6 +61,19 @@
     });
 });
 
+test('an explicitly null topic_type publishes as STANDARD', function () {
+    Http::fake([
+        config('trypost.platforms.google_business.local_posts_api').'/*' => Http::response(['name' => 'x'], 200),
+    ]);
+
+    $this->postPlatform->update(['meta' => ['topic_type' => null]]);
+
+    $this->publisher->publish($this->postPlatform->fresh());
+
+    Http::assertSent(fn ($request) => data_get($request->data(), 'topicType') === 'STANDARD'
+        && ! isset($request['event']));
+});
+
 test('includes a call to action when configured', function () {
     Http::fake([
         config('trypost.platforms.google_business.local_posts_api').'/*' => Http::response(['name' => 'x'], 200),
diff --git a/tests/Unit/PostPlatformMetaRulesTest.php b/tests/Unit/PostPlatformMetaRulesTest.php
index 88031fabd..ecfbdb66b 100644
--- a/tests/Unit/PostPlatformMetaRulesTest.php
+++ b/tests/Unit/PostPlatformMetaRulesTest.php
@@ -134,6 +134,16 @@
     expect($violation)->toBeNull();
 });
 
+test('google business meta with an explicitly null topic_type defaults to STANDARD', function () {
+    $reflection = new ReflectionMethod(PostPlatformMetaRules::class, 'requiredMetaViolation');
+
+    $explicitNull = $reflection->invoke(null, Platform::GoogleBusiness, ['topic_type' => null]);
+    $missing = $reflection->invoke(null, Platform::GoogleBusiness, []);
+
+    expect($explicitNull)->toBeNull()
+        ->and($missing)->toBeNull();
+});
+
 test('google business call_to_action with an explicitly null action_type has no url violation', function () {
     $violation = (new ReflectionMethod(PostPlatformMetaRules::class, 'requiredMetaViolation'))
         ->invoke(null, Platform::GoogleBusiness, [

From 2743dc76b454718d577d30623ab5cbc40580966a Mon Sep 17 00:00:00 2001
From: Paulo Castellano <paulo@castellanos.llc>
Date: Tue, 11 Aug 2026 09:20:01 -0300
Subject: [PATCH 39/47] fix: reject blank Google Business event dates instead
 of publishing today

CarbonImmutable::parse('') resolves to now(), so a blank start or end date
reaching publish() silently sent today's date to Google. buildEvent() now
throws the same way the missing-location guard does.
---
 .../Social/GoogleBusinessPublisher.php        | 14 ++++++--
 .../Social/GoogleBusinessPublisherTest.php    | 36 +++++++++++++++++++
 2 files changed, 48 insertions(+), 2 deletions(-)

diff --git a/app/Services/Social/GoogleBusinessPublisher.php b/app/Services/Social/GoogleBusinessPublisher.php
index 3ddabc877..18834db69 100644
--- a/app/Services/Social/GoogleBusinessPublisher.php
+++ b/app/Services/Social/GoogleBusinessPublisher.php
@@ -151,9 +151,19 @@ private function buildPayload(PostPlatform $postPlatform, string $content): arra
      */
     private function buildEvent(PostPlatform $postPlatform): array
     {
+        $startDate = (string) data_get($postPlatform->meta, 'event.start_date');
+        $endDate = (string) data_get($postPlatform->meta, 'event.end_date');
+
+        if (blank($startDate) || blank($endDate)) {
+            throw new GoogleBusinessPublishException(
+                userMessage: 'This Google Business Profile post needs an event start and end date. Please add them and try again.',
+                category: ErrorCategory::ContentPolicy,
+            );
+        }
+
         $schedule = [
-            'startDate' => $this->formatDate((string) data_get($postPlatform->meta, 'event.start_date')),
-            'endDate' => $this->formatDate((string) data_get($postPlatform->meta, 'event.end_date')),
+            'startDate' => $this->formatDate($startDate),
+            'endDate' => $this->formatDate($endDate),
         ];
 
         if (filled(data_get($postPlatform->meta, 'event.start_time'))) {
diff --git a/tests/Feature/Services/Social/GoogleBusinessPublisherTest.php b/tests/Feature/Services/Social/GoogleBusinessPublisherTest.php
index eaaafb518..19b5d91c1 100644
--- a/tests/Feature/Services/Social/GoogleBusinessPublisherTest.php
+++ b/tests/Feature/Services/Social/GoogleBusinessPublisherTest.php
@@ -74,6 +74,42 @@
         && ! isset($request['event']));
 });
 
+test('a blank event start date throws instead of silently publishing today', function () {
+    Http::fake([
+        config('trypost.platforms.google_business.local_posts_api').'/*' => Http::response(['name' => 'x'], 200),
+    ]);
+
+    $this->postPlatform->update([
+        'meta' => [
+            'topic_type' => 'EVENT',
+            'event' => ['title' => 'Grand Opening', 'start_date' => '', 'end_date' => '2026-09-02'],
+        ],
+    ]);
+
+    expect(fn () => $this->publisher->publish($this->postPlatform->fresh()))
+        ->toThrow(GoogleBusinessPublishException::class);
+
+    Http::assertNothingSent();
+});
+
+test('a missing event end date throws instead of silently publishing today', function () {
+    Http::fake([
+        config('trypost.platforms.google_business.local_posts_api').'/*' => Http::response(['name' => 'x'], 200),
+    ]);
+
+    $this->postPlatform->update([
+        'meta' => [
+            'topic_type' => 'OFFER',
+            'event' => ['title' => 'Summer Sale', 'start_date' => '2026-09-01', 'end_date' => null],
+        ],
+    ]);
+
+    expect(fn () => $this->publisher->publish($this->postPlatform->fresh()))
+        ->toThrow(GoogleBusinessPublishException::class);
+
+    Http::assertNothingSent();
+});
+
 test('includes a call to action when configured', function () {
     Http::fake([
         config('trypost.platforms.google_business.local_posts_api').'/*' => Http::response(['name' => 'x'], 200),

From 09bf8554440cf3dae486c023926a25b9ec091a1f Mon Sep 17 00:00:00 2001
From: Paulo Castellano <paulo@castellanos.llc>
Date: Tue, 11 Aug 2026 09:20:07 -0300
Subject: [PATCH 40/47] fix: clear the Google Business OAuth session on the
 unknown-location path

The location-not-found exit left live access and refresh tokens in the session,
unlike every other exit in select(). Also extracts the shared location
attribute builder so the reconnect branch stops duplicating connectLocation().
---
 .../Auth/GoogleBusinessController.php         | 59 +++++++++++--------
 .../Social/GoogleBusinessControllerTest.php   |  5 +-
 2 files changed, 39 insertions(+), 25 deletions(-)

diff --git a/app/Http/Controllers/Auth/GoogleBusinessController.php b/app/Http/Controllers/Auth/GoogleBusinessController.php
index 6332a94eb..a06cd8b1c 100644
--- a/app/Http/Controllers/Auth/GoogleBusinessController.php
+++ b/app/Http/Controllers/Auth/GoogleBusinessController.php
@@ -153,6 +153,8 @@ public function select(SelectGoogleBusinessLocationRequest $request): InertiaRes
                 ->firstWhere('id', $request->validated('location_id'));
 
             if (! $selectedLocation) {
+                session()->forget(['google_business_oauth', 'social_reconnect_id']);
+
                 return $this->popupCallback(false, __('accounts.popup_callback.location_not_found'), $this->platform->value);
             }
 
@@ -163,19 +165,14 @@ public function select(SelectGoogleBusinessLocationRequest $request): InertiaRes
 
                 if ($existingAccount) {
                     $existingAccount->update([
+                        ...$this->locationAttributes(
+                            $selectedLocation,
+                            data_get($oauthData, 'access_token'),
+                            data_get($oauthData, 'refresh_token'),
+                            data_get($oauthData, 'expires_in'),
+                            data_get($oauthData, 'user_id'),
+                        ),
                         'platform_user_id' => data_get($selectedLocation, 'id'),
-                        'username' => data_get($selectedLocation, 'title'),
-                        'display_name' => data_get($selectedLocation, 'title'),
-                        'access_token' => data_get($oauthData, 'access_token'),
-                        'refresh_token' => data_get($oauthData, 'refresh_token'),
-                        'token_expires_at' => data_get($oauthData, 'expires_in') ? now()->addSeconds(data_get($oauthData, 'expires_in')) : null,
-                        'scopes' => $this->scopes,
-                        'meta' => [
-                            'location_id' => data_get($selectedLocation, 'id'),
-                            'account_name' => data_get($selectedLocation, 'account_name'),
-                            'location_name' => data_get($selectedLocation, 'location_name'),
-                            'google_user_id' => data_get($oauthData, 'user_id'),
-                        ],
                     ]);
                     $existingAccount->markAsConnected();
 
@@ -216,25 +213,39 @@ private function connectLocation(Workspace $workspace, array $location, string $
                 'platform_user_id' => data_get($location, 'id'),
             ],
             [
-                'username' => data_get($location, 'title'),
-                'display_name' => data_get($location, 'title'),
-                'access_token' => $accessToken,
-                'refresh_token' => $refreshToken,
-                'token_expires_at' => $expiresIn ? now()->addSeconds($expiresIn) : null,
-                'scopes' => $this->scopes,
+                ...$this->locationAttributes($location, $accessToken, $refreshToken, $expiresIn, $googleUserId),
                 'status' => Status::Connected,
                 'error_message' => null,
                 'disconnected_at' => null,
-                'meta' => [
-                    'location_id' => data_get($location, 'id'),
-                    'account_name' => data_get($location, 'account_name'),
-                    'location_name' => data_get($location, 'location_name'),
-                    'google_user_id' => $googleUserId,
-                ],
             ],
         );
     }
 
+    /**
+     * The social account attributes derived from a picked location and its OAuth
+     * tokens. Shared by the fresh-connect and reconnect paths so both store the
+     * same shape.
+     *
+     * @return array<string, mixed>
+     */
+    private function locationAttributes(array $location, string $accessToken, ?string $refreshToken, ?int $expiresIn, ?string $googleUserId): array
+    {
+        return [
+            'username' => data_get($location, 'title'),
+            'display_name' => data_get($location, 'title'),
+            'access_token' => $accessToken,
+            'refresh_token' => $refreshToken,
+            'token_expires_at' => $expiresIn ? now()->addSeconds($expiresIn) : null,
+            'scopes' => $this->scopes,
+            'meta' => [
+                'location_id' => data_get($location, 'id'),
+                'account_name' => data_get($location, 'account_name'),
+                'location_name' => data_get($location, 'location_name'),
+                'google_user_id' => $googleUserId,
+            ],
+        ];
+    }
+
     private function redirectToGoogle(): Response
     {
         return Inertia::location(
diff --git a/tests/Feature/Social/GoogleBusinessControllerTest.php b/tests/Feature/Social/GoogleBusinessControllerTest.php
index 3aed1ff99..33d00d1e2 100644
--- a/tests/Feature/Social/GoogleBusinessControllerTest.php
+++ b/tests/Feature/Social/GoogleBusinessControllerTest.php
@@ -310,6 +310,7 @@
 test('select fails with an unknown location id', function () {
     session([
         'social_connect_workspace' => $this->workspace->id,
+        'social_reconnect_id' => 'some-account-id',
         'google_business_oauth' => [
             'access_token' => 'access-token',
             'refresh_token' => 'refresh-token',
@@ -330,7 +331,9 @@
         ->where('message', __('accounts.popup_callback.location_not_found'))
     );
 
-    expect($this->workspace->socialAccounts()->where('platform', Platform::GoogleBusiness)->exists())->toBeFalse();
+    expect($this->workspace->socialAccounts()->where('platform', Platform::GoogleBusiness)->exists())->toBeFalse()
+        ->and(session('google_business_oauth'))->toBeNull()
+        ->and(session('social_reconnect_id'))->toBeNull();
 });
 
 test('select fails with expired session', function () {

From e17aa3ec84b364be461e951f228712b5ac4c667c Mon Sep 17 00:00:00 2001
From: Paulo Castellano <paulo@castellanos.llc>
Date: Tue, 11 Aug 2026 09:20:07 -0300
Subject: [PATCH 41/47] docs: add Google Business Profile to the platform API
 documentation list

---
 CLAUDE.md | 1 +
 1 file changed, 1 insertion(+)

diff --git a/CLAUDE.md b/CLAUDE.md
index c2123195a..3ab5639bd 100644
--- a/CLAUDE.md
+++ b/CLAUDE.md
@@ -370,6 +370,7 @@ Standing constraints:
 - **Bluesky / AT Protocol**: official lexicons — https://github.com/bluesky-social/atproto/tree/main/lexicons/com/atproto/repo ; HTTP API reference — https://docs.bsky.app
 - **Discord**: Webhook resource (used for our webhook-based publishing) — https://docs.discord.com/developers/resources/webhook
 - **Telegram**: Bot API — https://core.telegram.org/bots/api
+- **Google Business Profile**: Business Information API, Account Management API, Business Profile Performance API — https://developers.google.com/my-business/reference/rest ; legacy but still-active Local Posts v4 API (the only endpoint for creating/updating/deleting Local Posts) — https://developers.google.com/my-business/reference/rest/v4/accounts.locations.localPosts
 
 ## TryPost.it Documentation
 

From c60d0a6ee13fdee9cf158fc6d18eb85611fb6ca3 Mon Sep 17 00:00:00 2001
From: Paulo Castellano <paulo@castellanos.llc>
Date: Tue, 11 Aug 2026 09:35:28 -0300
Subject: [PATCH 42/47] fix: reject a blank Google Business event title instead
 of publishing it

---
 .../Social/GoogleBusinessPublisher.php         | 11 ++++++++++-
 .../Social/GoogleBusinessPublisherTest.php     | 18 ++++++++++++++++++
 2 files changed, 28 insertions(+), 1 deletion(-)

diff --git a/app/Services/Social/GoogleBusinessPublisher.php b/app/Services/Social/GoogleBusinessPublisher.php
index 18834db69..e809651cc 100644
--- a/app/Services/Social/GoogleBusinessPublisher.php
+++ b/app/Services/Social/GoogleBusinessPublisher.php
@@ -151,6 +151,15 @@ private function buildPayload(PostPlatform $postPlatform, string $content): arra
      */
     private function buildEvent(PostPlatform $postPlatform): array
     {
+        $title = (string) data_get($postPlatform->meta, 'event.title');
+
+        if (blank($title)) {
+            throw new GoogleBusinessPublishException(
+                userMessage: 'This Google Business Profile post needs an event title. Please add one and try again.',
+                category: ErrorCategory::ContentPolicy,
+            );
+        }
+
         $startDate = (string) data_get($postPlatform->meta, 'event.start_date');
         $endDate = (string) data_get($postPlatform->meta, 'event.end_date');
 
@@ -175,7 +184,7 @@ private function buildEvent(PostPlatform $postPlatform): array
         }
 
         return [
-            'title' => (string) data_get($postPlatform->meta, 'event.title'),
+            'title' => $title,
             'schedule' => $schedule,
         ];
     }
diff --git a/tests/Feature/Services/Social/GoogleBusinessPublisherTest.php b/tests/Feature/Services/Social/GoogleBusinessPublisherTest.php
index 19b5d91c1..ceab26afc 100644
--- a/tests/Feature/Services/Social/GoogleBusinessPublisherTest.php
+++ b/tests/Feature/Services/Social/GoogleBusinessPublisherTest.php
@@ -74,6 +74,24 @@
         && ! isset($request['event']));
 });
 
+test('a blank event title throws instead of publishing an untitled event', function () {
+    Http::fake([
+        config('trypost.platforms.google_business.local_posts_api').'/*' => Http::response(['name' => 'x'], 200),
+    ]);
+
+    $this->postPlatform->update([
+        'meta' => [
+            'topic_type' => 'EVENT',
+            'event' => ['title' => '', 'start_date' => '2026-09-01', 'end_date' => '2026-09-02'],
+        ],
+    ]);
+
+    expect(fn () => $this->publisher->publish($this->postPlatform->fresh()))
+        ->toThrow(GoogleBusinessPublishException::class);
+
+    Http::assertNothingSent();
+});
+
 test('a blank event start date throws instead of silently publishing today', function () {
     Http::fake([
         config('trypost.platforms.google_business.local_posts_api').'/*' => Http::response(['name' => 'x'], 200),

From 7c020909c5cbcb122564a2a4e5f0e61ad14b2600 Mon Sep 17 00:00:00 2001
From: Paulo Castellano <paulo@castellanos.llc>
Date: Tue, 11 Aug 2026 09:36:01 -0300
Subject: [PATCH 43/47] fix: guard the Google Business verify call against a
 missing location name

---
 app/Services/Social/ConnectionVerifier.php         | 10 +++++++++-
 .../Services/Social/ConnectionVerifierTest.php     | 14 ++++++++++++++
 2 files changed, 23 insertions(+), 1 deletion(-)

diff --git a/app/Services/Social/ConnectionVerifier.php b/app/Services/Social/ConnectionVerifier.php
index 7f8e3204e..d8fb165e7 100644
--- a/app/Services/Social/ConnectionVerifier.php
+++ b/app/Services/Social/ConnectionVerifier.php
@@ -8,6 +8,7 @@
 use App\Exceptions\PlatformUnavailableException;
 use App\Exceptions\Social\BlueskyPublishException;
 use App\Exceptions\Social\DiscordPublishException;
+use App\Exceptions\Social\ErrorCategory;
 use App\Exceptions\Social\GoogleBusinessPublishException;
 use App\Exceptions\Social\LinkedInPublishException;
 use App\Exceptions\Social\MastodonPublishException;
@@ -671,7 +672,14 @@ private function verifyMastodon(SocialAccount $account): bool
 
     private function verifyGoogleBusiness(SocialAccount $account): bool
     {
-        $locationName = data_get($account->meta, 'location_name');
+        $locationName = (string) data_get($account->meta, 'location_name');
+
+        if (blank($locationName)) {
+            throw new GoogleBusinessPublishException(
+                userMessage: 'This Google Business Profile account has no location configured. Please reconnect it.',
+                category: ErrorCategory::Permission,
+            );
+        }
 
         $response = Http::withToken($account->access_token)
             ->get(config('trypost.platforms.google_business.business_information_api')."/{$locationName}", [
diff --git a/tests/Feature/Services/Social/ConnectionVerifierTest.php b/tests/Feature/Services/Social/ConnectionVerifierTest.php
index ca9d548ae..c562c4612 100644
--- a/tests/Feature/Services/Social/ConnectionVerifierTest.php
+++ b/tests/Feature/Services/Social/ConnectionVerifierTest.php
@@ -4,6 +4,7 @@
 
 use App\Enums\SocialAccount\Status;
 use App\Exceptions\PlatformUnavailableException;
+use App\Exceptions\Social\GoogleBusinessPublishException;
 use App\Exceptions\TokenExpiredException;
 use App\Models\SocialAccount;
 use App\Services\Social\ConnectionVerifier;
@@ -1216,6 +1217,19 @@
     Http::assertSent(fn ($request) => Str::before($request->url(), '?') === $expectedUrl);
 });
 
+test('verify throws an actionable exception when the google business location name is missing', function () {
+    $account = SocialAccount::factory()->googleBusiness()->create([
+        'meta' => ['location_id' => 'accounts/123456789/locations/987654321'],
+    ]);
+
+    Http::fake();
+
+    expect(fn () => app(ConnectionVerifier::class)->verify($account))
+        ->toThrow(GoogleBusinessPublishException::class);
+
+    Http::assertNothingSent();
+});
+
 test('verify throws token expired for a dead google business token', function () {
     $account = SocialAccount::factory()->googleBusiness()->create();
 

From 903f6b9f5baf68381062e06a668647e8e40ce234 Mon Sep 17 00:00:00 2001
From: Paulo Castellano <paulo@castellanos.llc>
Date: Tue, 11 Aug 2026 09:36:43 -0300
Subject: [PATCH 44/47] refactor: share the Google Business short-to-full
 location name conversion

---
 .../Social/GoogleBusinessPublisher.php        |  5 +---
 app/Support/GoogleBusinessResourceName.php    | 14 +++++++++++
 tests/Unit/GoogleBusinessResourceNameTest.php | 23 +++++++++++++++++++
 3 files changed, 38 insertions(+), 4 deletions(-)
 create mode 100644 tests/Unit/GoogleBusinessResourceNameTest.php

diff --git a/app/Services/Social/GoogleBusinessPublisher.php b/app/Services/Social/GoogleBusinessPublisher.php
index e809651cc..fbd999b20 100644
--- a/app/Services/Social/GoogleBusinessPublisher.php
+++ b/app/Services/Social/GoogleBusinessPublisher.php
@@ -282,12 +282,9 @@ private function fetchLocationsForAccount(string $accessToken, string $accountNa
 
             foreach (data_get($data, 'locations', []) as $location) {
                 $shortName = (string) data_get($location, 'name');
-                $numericId = str_starts_with($shortName, 'locations/')
-                    ? substr($shortName, strlen('locations/'))
-                    : $shortName;
 
                 $locations[] = [
-                    'id' => "{$accountName}/locations/{$numericId}",
+                    'id' => GoogleBusinessResourceName::toFullLocationName($accountName, $shortName),
                     'account_name' => $accountName,
                     'location_name' => $shortName,
                     'title' => (string) data_get($location, 'title'),
diff --git a/app/Support/GoogleBusinessResourceName.php b/app/Support/GoogleBusinessResourceName.php
index b6d55e62c..f2d19abfd 100644
--- a/app/Support/GoogleBusinessResourceName.php
+++ b/app/Support/GoogleBusinessResourceName.php
@@ -23,4 +23,18 @@ public static function dashboardUrl(string $resourceName): string
 
         return 'https://business.google.com/locations/'.end($segments);
     }
+
+    /**
+     * The full `accounts/{account}/locations/{location}` name the v4 Local Posts
+     * API needs, built from an account name and the short `locations/{location}`
+     * name the v1 Business Information API returns.
+     */
+    public static function toFullLocationName(string $accountName, string $shortLocationName): string
+    {
+        $locationId = str_starts_with($shortLocationName, 'locations/')
+            ? substr($shortLocationName, strlen('locations/'))
+            : $shortLocationName;
+
+        return "{$accountName}/locations/{$locationId}";
+    }
 }
diff --git a/tests/Unit/GoogleBusinessResourceNameTest.php b/tests/Unit/GoogleBusinessResourceNameTest.php
new file mode 100644
index 000000000..94667f599
--- /dev/null
+++ b/tests/Unit/GoogleBusinessResourceNameTest.php
@@ -0,0 +1,23 @@
+<?php
+
+declare(strict_types=1);
+
+use App\Support\GoogleBusinessResourceName;
+
+test('dashboardUrl links by the trailing location id', function () {
+    expect(GoogleBusinessResourceName::dashboardUrl('accounts/111/locations/222'))
+        ->toBe('https://business.google.com/locations/222');
+
+    expect(GoogleBusinessResourceName::dashboardUrl('locations/222'))
+        ->toBe('https://business.google.com/locations/222');
+});
+
+test('toFullLocationName composes the account name with the location id', function () {
+    expect(GoogleBusinessResourceName::toFullLocationName('accounts/111', 'locations/222'))
+        ->toBe('accounts/111/locations/222');
+});
+
+test('toFullLocationName accepts a bare location id', function () {
+    expect(GoogleBusinessResourceName::toFullLocationName('accounts/111', '222'))
+        ->toBe('accounts/111/locations/222');
+});

From a6dbd8eb0bf49b1a99a7fc1cf47b2615191bb3ff Mon Sep 17 00:00:00 2001
From: Paulo Castellano <paulo@castellanos.llc>
Date: Tue, 11 Aug 2026 09:38:43 -0300
Subject: [PATCH 45/47] test: cover the untested Google Business meta fields
 across the API and MCP entry points

---
 tests/Feature/Api/PostApiPlatformMetaTest.php | 81 ++++++++++++++++++
 .../Feature/Mcp/PostPlatformMetaToolTest.php  | 84 +++++++++++++++++++
 2 files changed, 165 insertions(+)

diff --git a/tests/Feature/Api/PostApiPlatformMetaTest.php b/tests/Feature/Api/PostApiPlatformMetaTest.php
index 5f8a2de89..d385cc122 100644
--- a/tests/Feature/Api/PostApiPlatformMetaTest.php
+++ b/tests/Feature/Api/PostApiPlatformMetaTest.php
@@ -413,6 +413,87 @@
         ->and(data_get($meta, 'offer.coupon_code'))->toBe('SAVE10');
 });
 
+it('persists Google Business call_to_action meta on store', function () {
+    $googleBusiness = SocialAccount::factory()->googleBusiness()->create(['workspace_id' => $this->workspace->id]);
+
+    $this->withHeaders($this->headers)
+        ->postJson(route('api.posts.store'), [
+            'content' => 'Book a table tonight',
+            'platforms' => [[
+                'social_account_id' => $googleBusiness->id,
+                'content_type' => ContentType::GoogleBusinessPost->value,
+                'meta' => [
+                    'call_to_action' => ['action_type' => 'BOOK', 'url' => 'https://example.com'],
+                ],
+            ]],
+        ])
+        ->assertCreated();
+
+    $meta = PostPlatform::where('social_account_id', $googleBusiness->id)->sole()->meta;
+
+    expect(data_get($meta, 'call_to_action.action_type'))->toBe('BOOK')
+        ->and(data_get($meta, 'call_to_action.url'))->toBe('https://example.com');
+});
+
+it('persists Google Business event time meta on store', function () {
+    $googleBusiness = SocialAccount::factory()->googleBusiness()->create(['workspace_id' => $this->workspace->id]);
+
+    $this->withHeaders($this->headers)
+        ->postJson(route('api.posts.store'), [
+            'content' => 'Grand opening',
+            'platforms' => [[
+                'social_account_id' => $googleBusiness->id,
+                'content_type' => ContentType::GoogleBusinessPost->value,
+                'meta' => [
+                    'topic_type' => 'EVENT',
+                    'event' => [
+                        'title' => 'Grand Opening',
+                        'start_date' => '2026-09-01',
+                        'end_date' => '2026-09-02',
+                        'start_time' => '09:00',
+                        'end_time' => '17:00',
+                    ],
+                ],
+            ]],
+        ])
+        ->assertCreated();
+
+    $meta = PostPlatform::where('social_account_id', $googleBusiness->id)->sole()->meta;
+
+    expect(data_get($meta, 'event.title'))->toBe('Grand Opening')
+        ->and(data_get($meta, 'event.start_date'))->toBe('2026-09-01')
+        ->and(data_get($meta, 'event.end_date'))->toBe('2026-09-02')
+        ->and(data_get($meta, 'event.start_time'))->toBe('09:00')
+        ->and(data_get($meta, 'event.end_time'))->toBe('17:00');
+});
+
+it('persists Google Business offer redeem url and terms meta on store', function () {
+    $googleBusiness = SocialAccount::factory()->googleBusiness()->create(['workspace_id' => $this->workspace->id]);
+
+    $this->withHeaders($this->headers)
+        ->postJson(route('api.posts.store'), [
+            'content' => 'Big sale this week',
+            'platforms' => [[
+                'social_account_id' => $googleBusiness->id,
+                'content_type' => ContentType::GoogleBusinessPost->value,
+                'meta' => [
+                    'offer' => [
+                        'coupon_code' => 'SAVE10',
+                        'redeem_online_url' => 'https://example.com/redeem',
+                        'terms_conditions' => 'Some terms',
+                    ],
+                ],
+            ]],
+        ])
+        ->assertCreated();
+
+    $meta = PostPlatform::where('social_account_id', $googleBusiness->id)->sole()->meta;
+
+    expect(data_get($meta, 'offer.coupon_code'))->toBe('SAVE10')
+        ->and(data_get($meta, 'offer.redeem_online_url'))->toBe('https://example.com/redeem')
+        ->and(data_get($meta, 'offer.terms_conditions'))->toBe('Some terms');
+});
+
 it('rejects publishing a Google Business event post without event fields', function () {
     $googleBusiness = SocialAccount::factory()->googleBusiness()->create(['workspace_id' => $this->workspace->id]);
     $post = Post::factory()->create(['workspace_id' => $this->workspace->id, 'user_id' => $this->user->id]);
diff --git a/tests/Feature/Mcp/PostPlatformMetaToolTest.php b/tests/Feature/Mcp/PostPlatformMetaToolTest.php
index 6acdbeb14..5a35fff38 100644
--- a/tests/Feature/Mcp/PostPlatformMetaToolTest.php
+++ b/tests/Feature/Mcp/PostPlatformMetaToolTest.php
@@ -394,6 +394,90 @@
         ->and(data_get($meta, 'offer.coupon_code'))->toBe('SAVE10');
 });
 
+test('create post persists Google Business call_to_action meta', function () {
+    $googleBusiness = SocialAccount::factory()->googleBusiness()->create(['workspace_id' => $this->workspace->id]);
+
+    $response = TryPostServer::actingAs($this->user)
+        ->tool(CreatePostTool::class, [
+            'content' => 'Book a table tonight',
+            'platforms' => [[
+                'social_account_id' => $googleBusiness->id,
+                'content_type' => ContentType::GoogleBusinessPost->value,
+                'meta' => [
+                    'call_to_action' => ['action_type' => 'BOOK', 'url' => 'https://example.com'],
+                ],
+            ]],
+        ]);
+
+    $response->assertOk();
+
+    $meta = PostPlatform::where('social_account_id', $googleBusiness->id)->sole()->meta;
+
+    expect(data_get($meta, 'call_to_action.action_type'))->toBe('BOOK')
+        ->and(data_get($meta, 'call_to_action.url'))->toBe('https://example.com');
+});
+
+test('create post persists Google Business event time meta', function () {
+    $googleBusiness = SocialAccount::factory()->googleBusiness()->create(['workspace_id' => $this->workspace->id]);
+
+    $response = TryPostServer::actingAs($this->user)
+        ->tool(CreatePostTool::class, [
+            'content' => 'Grand opening',
+            'platforms' => [[
+                'social_account_id' => $googleBusiness->id,
+                'content_type' => ContentType::GoogleBusinessPost->value,
+                'meta' => [
+                    'topic_type' => 'EVENT',
+                    'event' => [
+                        'title' => 'Grand Opening',
+                        'start_date' => '2026-09-01',
+                        'end_date' => '2026-09-02',
+                        'start_time' => '09:00',
+                        'end_time' => '17:00',
+                    ],
+                ],
+            ]],
+        ]);
+
+    $response->assertOk();
+
+    $meta = PostPlatform::where('social_account_id', $googleBusiness->id)->sole()->meta;
+
+    expect(data_get($meta, 'event.title'))->toBe('Grand Opening')
+        ->and(data_get($meta, 'event.start_date'))->toBe('2026-09-01')
+        ->and(data_get($meta, 'event.end_date'))->toBe('2026-09-02')
+        ->and(data_get($meta, 'event.start_time'))->toBe('09:00')
+        ->and(data_get($meta, 'event.end_time'))->toBe('17:00');
+});
+
+test('create post persists Google Business offer redeem url and terms meta', function () {
+    $googleBusiness = SocialAccount::factory()->googleBusiness()->create(['workspace_id' => $this->workspace->id]);
+
+    $response = TryPostServer::actingAs($this->user)
+        ->tool(CreatePostTool::class, [
+            'content' => 'Big sale this week',
+            'platforms' => [[
+                'social_account_id' => $googleBusiness->id,
+                'content_type' => ContentType::GoogleBusinessPost->value,
+                'meta' => [
+                    'offer' => [
+                        'coupon_code' => 'SAVE10',
+                        'redeem_online_url' => 'https://example.com/redeem',
+                        'terms_conditions' => 'Some terms',
+                    ],
+                ],
+            ]],
+        ]);
+
+    $response->assertOk();
+
+    $meta = PostPlatform::where('social_account_id', $googleBusiness->id)->sole()->meta;
+
+    expect(data_get($meta, 'offer.coupon_code'))->toBe('SAVE10')
+        ->and(data_get($meta, 'offer.redeem_online_url'))->toBe('https://example.com/redeem')
+        ->and(data_get($meta, 'offer.terms_conditions'))->toBe('Some terms');
+});
+
 test('publish post rejects a Google Business event post without event fields', function () {
     $googleBusiness = SocialAccount::factory()->googleBusiness()->create(['workspace_id' => $this->workspace->id]);
 

From 301f908344585a1f6d9c85d4b936c968f466020d Mon Sep 17 00:00:00 2001
From: Paulo Castellano <paulo@castellanos.llc>
Date: Tue, 11 Aug 2026 11:08:34 -0300
Subject: [PATCH 46/47] fix: replace the Google Business Profile placeholder
 icon with the real brand icon

---
 public/images/accounts/google_business.png | Bin 479 -> 16779 bytes
 1 file changed, 0 insertions(+), 0 deletions(-)

diff --git a/public/images/accounts/google_business.png b/public/images/accounts/google_business.png
index 0b45bc84e80108d2e0350bb1974f746a1a7767a5..2ff782a9e9be0b0a799ecb110e619866608edde4 100644
GIT binary patch
literal 16779
zcmeHuXH-*Nw=M}ydhacC={qz50i{S0lqyA}gb*MS5=cUo7Mci16A+{$0)jL_1O=2L
z(z{}%hzimb5F2n4EU)kPy=R>7oN>p!f6N$=z4o4KuC?Zxb3XG~8!niiG-ROVr6nUH
zV=y+-w<LZml70?Q5q}FFiK`<cQ?7!;bnQsrXZ^fgNw<mLZg52(7#Ry0a|9V#1({lo
zFZuorqSW~xQYXGkdH-Ds=7w=aX!v2#8h(CAHx0PEk~>006(I*z2M)<8s{?9sYKm@f
zIXGO!6^a0$D(dc}>455gD3$uI6o&h^q2*yX90H3+V$e8Z2eQc@9VGTUxMHyX&;kBS
z`Z}B_QRD&peur??{ri;{X-)D7HzXe6=8eO+;{#w=gpLOSjrZ0etpj3!#3I~LLB4KC
z4<sIjvcmXb;Rx#>A4H&)Cm!#kp`ZZwmq+^G;qn-)hXNWAfP-V)5IBV&^0<9@JW*Z&
zj`8-v;D`g+BJrNqSQrwGaMM9~V6eodHxhn=I0+bWS(QJQb@0DlmM0A7Denfulf=o+
zkrsCCEFut&^23pALnubz@GvZ%Ti6|iKzrald6b*o&@gWVnxxqs;tfM1-H9S_7|O#P
z=Lu6(QFS9}w1WhgN~+Ouw)r#7wy)HZ>rE!Vb7b5z->@l3_r^E53q`|yU~WdFF~5Jn
zm>*LW+n=f;9QE%z07t=)-b8V*9%-88o^EgrJQ9yWU<?sx1QtfLI>gu;=7B&GAGl+%
z-Y`58Nop(jpgqna(Zq$I;Rs{>K-oZV9}OhYos`sFRn?T#5pr&B08~!d4W=RoQ-rC?
zxgAnHr0xb+g~HX9F#DrA6L*m`1O^*;Xn!xA%{?)A49*kdqoAlNuPP5f_FdJP<N^wS
zJXBd;5kk6_!{UfdWhHq4|1XN1k!W`e;oiPAG2i{;mrf6V1eRof_wTwf#O;>f*Dvqt
zheWvr@+ks}Du6PeDDN$=1Smlvu2AAq+(`QY-$UY%9%vZe4@-0_90KJoy1!Lg3j0&r
z*YZCLsQr%ezm%T+D{>->;eJ?DpyY3(?1#W#65sp&2$Ub5aU9v+x>r7>0|d5-tqgpE
zYP65KWhmSD7BYBI)gPLu`L0yzzf=0laet_NG!T{TcbV2HLizsV=L=l=#v1v(3(E^y
z96owliybp}e{)eXGJyGqyM2!gMfg8th+iuvx}3rc$>qkP?HSmML26>$!jbk=g+L@#
zE)Yo(T}TcFfx+y?IEa_F-*hjkCfsIEPP(f0DD_K#fr>^t)+lzH0R*C>Bm?}QbN~$%
z`6&u2Ht;Dcs3;&zYS6Ores=(?ARHdyje{7Y;TWtBX5Xiw0stRLh>nf@yO1^34~K_X
zA+Y{PI06S10U)Hu<ZL|OADd$_Zhr8;1R#dWfFKuxq6!oM4nb9wh?(;=v8no76ChMV
z*#MS(HT1OK)#xdj>p%|z68l5b3+Z9dcw!=h==kA1iQh;#5+6jICK8V%Mwvh2XLs74
z-H9uZhq3@nr0&%82drRd$Z-trm)rq*T0IyFNsLl7683kSKmfsCHlqP?vcO?TIgAhP
zD2$Xs<%y91M1n+qw=0N}j64#=L`J+%3yuVV$U2$Z2_vCe*mqFe`r9ZMR~;MrjV+|)
z%K3?>no%bkUW>=(VO|LpDRJ6xs`I>LwYU>asP0O0;fxN03`om}>~_{QS@cml?_EB<
z_ELJTTK1?4R=fh5C!Cn)*&XAx>)CQ<FDE(8N{in&aj|o0jQntFuW(r@O$)E*u95B;
zh4*nn8tGfN6kj|S8N65y$0#O;R-*MP0?Edd@=lgV9?v9z*lp_u`pbqgv}L^LD!9rG
z+l`?m_z=XiUE0(k9uW#VA4}F@ljj<rfwEyUYqwro@6mg4mRDcuJup{WJZ~z;Nv-re
zV#(4bGg!*|V6c3ji{TyVjW&4fsDq`}qOUrb97G1X8VOn=T4WxeCvJfN8wj*V0S3qb
z0aA;Rf|G*XZi_r@#GQUNiP5I$vaa#iUCEAJK#25Ml!6=Jj9?$B(v4paW~UbKzI<P=
zTr_6kmYgWSND^QoX`>(qQ%3;Oq_#K($&tT1x&jD9Pem(31)=~&EjWQeR0oLHl$6xu
z6aXROX9EPHzyny|;LkPyisk=-fEYN=M;?Pl$df=1PK4<FEjRcj369nHiIp(YW8A+9
zE9^V)k1+TdCWgxLa4a4$Bu!U{;wYdEXclS|s>Q1QRE9<U4-}yQLJ~<6gn|$Y5TZyc
z`?-2BIe-Ive@+(+1`zacdyF51SPDSU7(B!Wf%Qh>Nmzx)K>TnB2;LKkgP0PRiY7Mn
zNHvK&5>5m&2oZ%5K6nTW_gf#=Afh}1g8Cs2^S~kyL@>t7{~i#;L_;1429f0)#y#+<
zvIw&+(sQa4EK=ba)<_j|;VNRhf59ma$?_0kX$FU%+<c?qSMF{3KKuzKq|-ati?T4n
zS=B?^@NO9Q$iNr&f}3N#X+>wj){M8*uBcy!yc?AF7PqOO6Wq;8_HuIDt>`aFXtL(I
zO@*pb7t8qMds4GfV5PI+V}}!cchx0qQzA}q=lUdzI9JBiu*M4*C&mg86BnB;E2i3<
zo%>3=o?vqM2wKm+EO5TKo^V~n`7kSU=e_XLzNWBm7DAtmp55i1^OuUf_JT67ATeDz
znZ>j`^<uU6y`Gu=1(uA)rupsWgP|FXK1H~<wPR-LXV?vC&B^>Opr?Xfk4c{yO?6JX
z<e9T^!HSdIA>k1yPpeN(J~}n6OXTv=XM(KF@3zW7bEn-=4_pqN-`UYPFRQ*lC;R-J
zpS4Nm<i|zrk3}Wap<2v+{7VBWP3x8?rY;y)m=kDEP|ec@98SB=^CG$O$x&YA-s&&D
zH+?Q2uh2l`u1VOwmbgylb!~dvwQosQCeQT4`$GMr#vdr0z9dBrOi?^m#GcX=eKR3+
zte>f>uN2ZS4w003({NtAMo@ZL@l8|T^KBQ8!l^PZrknt6qeEY$4K1Sw<7b)B2d_Pq
zgOAA8-~$et&)~nV?cN)`l<@M_h1WgQXEroF`gkS;`i=^X>fNlReZ)88l^}T2p2~v=
zQE(zenS6&RX2#h&(^Y}h7>QO3@hs{%g@5rH0QL7&{C@+UcmOV9q!8hW`8%#yVu(SY
zrvoum+(#v4C{z*n{vo20GO-C&S5#6_S5ZIx{|hW5!T$~~U=qB5iSR-Us~g8YMbz0D
zwG6$B%zo8z;pDUW5<ONU(4Kr5M?h}ieP+7Mf*#q)AXJLPg_Fxt#WOF|+a~MqS{v4~
zR4Wh23WBI_JWf!3N@cQmeHDm(Ns9qV2^cP2)yU0^n+cEO!P*P8_(PFNJA>2SD~1sZ
z1uv#Nymxu}5!usGuPb{d6;u4&sinuE?3t-jAu>Vr(XV6zGfp#wCaX<tw;sAJFJXaA
zMxbAeE!9}NFgsuMJ4(hTH6HDnVG~2kXOnYf>8*U#CwYemUsifH{jPPBSm60Ww&H!4
zi@7shm%Dj;ud5;Kd9@WEy!w=Hxnm=nvw#U8AUc+`%bobiSIn7}OyebewUk5?aF>-2
zpmI-LWH<L7<sVlOMyZqM(3dQ18-Q92#}`s7l4)dCS%i{@W_%vmUecg3@+G6s7gNQe
z-!=(`yRNzB3-DP;>Go17HlD7`cVX!6vq8(`C7Esq8P=l7S(k+N{6%8Mhx`U*8EK;E
zv#NCjV>4QvWuo&(3NXcpF=KD!i-?++DpG-E;XIt%w9F4m9zJB;VZXSZdVVrrpW^|y
zcnNjkM60OM;tVxs%BqtXHrNfGG|+nj1s%&jPc16YxM?2Cd_?>cg-@NFMfYc@2DoNs
z9kR-EHtKZR7)I<hb%QsXPOVIIoc3Orb(QKPtwxvCTzB2TaYFstcX%ai1B6Y0m4pKO
z;CcX{BBCPEJph&O7$XnJ0@8&C3ngO3e#4kwRgA*^6_ywc9*RV0Lj4_CL9u}CcYrYm
zP6DRCqstLM>leC!IH4rnI3jZl2nhH=5r`#{f;SQeSMc#dD)<nqL1&yl9N`T2!O45#
zy-~lF0RM>azn1`|{IlNHVy5NEM%a7k>xqwEFGDB(C1>m-O=@Pjp4G`AyXGP<OjhY*
z3gGm1gN{}kvq@&qiPiJ*$1s-fkLhz~Fx*G3&)^iFL<(|yXq1K)eHqHOy<xmA36JRd
z=AM7@*3}c|F5N2+{mQJr%*1x?<0<muQxUmq24<G?k2XKfYtMg?veaVKhnn`)DWfur
zO;1r@QjfU^3s?R;>r`~)$k@<Dx4Y1y7iyOmb&kEL5zSJK`a1JKl}YyyoN_S^vTh%W
zHWR&ep?!(Qq1xNAB5wljo_2INedVdIf^@R}&>>#ku-fH|>TMbsJD1!Q`s`MR-zVJc
zt^LUBbN_8CL4+~p^yp*u$RebS0K;+nxB2)@{e+_e84L_(q|CB+?{`U@c)u!?@=U>h
zZn9UsXD(=P{k>_O@l9h>hb=y=-R!sJ$_t4cZiLWeR5XT;XXG942CEg{K-v0k#Atoz
za^>gJ7mFEPFinXf>NTl=tj4?QAhCC~^hrer)p?-JqnE-Brh1(|imaMu8XI|xZA;$j
zhrE4j!OanUc_WK!71bi7kGzE}$qikORM`1uX4KbEk(FltYJ%aBH@w}b_gk$b>q=*(
zH|t2Fx7}h9>sP3{{MT^7a~z-<Ki?AhuDuwv?P0G(b4(>mj(kk^sTlMP@TBaNV?+5z
zqsFg?0@RmhdN<rp(^4ekfQ$w%;7O}ZjTrgp^sC03@`Ej5SKWzZ$r^_*LgI0FYm67M
zmLU|u{b4A3MtdNV@f1L0NW=un_|uUYK-A#ENJcH<Ep;%69Lhv;DwkLz5Q3ZnOswYt
zLL?R458gz>45BE+QTPHFFbMQrDs~4&4FaJ5(uo2ht8rUKTzBCPKFeB5i923xwr3)=
z<KTniPNtGPk7=LY1~bDxafwjY<P(Z+*n{Hq{JglCNKBfDL5HA908~-^G?<30KjLhM
z%_8_-VI<u%Ad*rLh$N@_fuA%y4DGVH=btO?(B3j{T`~EWSOAcJ$4@SRgM@vwY>fKE
zVwP0f$&#p@JX8lbLV7^XruOpzWS`X$t3pF%h&9q1VTFfz`ykOC5KAi^Wk6jOVr8U5
zJY0d0rb~oR=yys7s6vS}j`Sgdr;;k54h4RKr}KX}l|%daiZ~Vd@A&*<oMU==q~S<Y
zA)cFf`#>xaI3En!4T1eW1t?$-uu)MH_h?9qROIhpkb|hnb;&3+vU?vrHCi*-h@0%b
z=>yrA66y0<`>dI`<J!sj*=>ahEgBH7f<`}d7<BwrTXilL-*7j}gL_s$2qsx)%5wb!
zk-B6MsY~jANnIfRMOV?j9Le|$hUya864fJiJRE<cE^8R8<L_Qmg#`D#O0oH<Fk!sh
zfAa4MmPlPVNeNb*L}lm!+Mg+v`~X16_}L)R6ha(8hylcY-XRhd?jPBFpQ!weq&WVP
z0>@hX%=te^%I|^-KR5lyo*OFvzT-bO{QEwTwwt)y``pEuG+!YKJHQ68F0?E(k3IQw
z3@l3NZ*=K@H2`Y=9Dzt_h!q=ffQrh4Ko25PM!Mfa?(e4=`>FqU?ymGu^Xqqw`AZir
zrp+h>Q#y0SWUu8VA0YTyz2=XuncdWL8oy@=I=Q@5_GKuk@Yxe7#@GiXCYCF=8P9eE
zn$}Q`svisQATv2W*E(E#_~83N?<+=&48j{x%%k<RT;Fsai*%({E1JINAS{;!9Q^cb
z>~MCY&Z&~z#U!(r<ptJfZxl;?sHEYp6-k?zkkrw)pIcluKJf|P--4@Ie605V5pc<A
zz$qZ^idKh0iqV^oL95wSw~vDej}Q0Le=;x_`!<O5s4#zNlA)%)!eAzy7TFCcm8QMX
zg?MZHpt$bRMxsgjVd;LR@e9c^lZU(V1-HL+z4wXriJqcX4SG(!LYCp*5ulNly?jX?
z16Jjujoa)2c(E7w!rZ?0kFbr?4T<Yb8#VR!d{CD(MQ&dfNa%iO5KB&$gc{5ra4XGw
zWK%OTeBPGoEc|G-@<i%`R4&u<QPbY`(Oa|D(%McQnMXc0+$ni}GRh2wf^^Z+RI8e2
z_Qc2);afcTr&&vnV}njM5>9fMWm?!*l%l_B&w`91@CWU-6AzOkt%D2fX!$W-U(tOM
zksr#TQ$cCatLOl^rCiq(gEZ)>Rl4V3_7^2|l@48J0@q{(dGRNNxBZ3J#*iIuDh2%u
zl%KOg=?;n7kgr!0;smx@aQePsTf7|3-IW`mT_L;%+Fh1{rbLF(Kx7!XKQbi4!yC4g
zd&1fBNA*PLHH>5bHAA}oJuPt%lgNICr2iQcqy!25K^o}Tm`P>L@38|F-VbzQzT*DX
z<7evJrxrg?y8sp7&|j%h4S+(Gf2PL&hgtf+;}Q*l&~e%<9c-JX!F~Q4e$THOc;Xu@
zxbjX^U1UhVm7N(SYrUd(mL*w*OA)18@tLny12<c=d%eX;o>x<}{K+)ymdFxaaZcv5
zvK8^j)AY|(KBa#3cr9RbEpfaeH%4z4blW(h3p6DV<)O!WIh(tzZO-L^xub;P*A=;H
z?TD+(ux}K1>nPAiTfge~cSh65SzlttD1rncbzJEmi>PY`YCMVY=_<K?_}DY9k>QY$
z<0g%#2YW)4oiJs$uXwm*9O6BD2Q_|RBB>jb26C$wX}zU;A?K^+h+Vm_l**~dr|FuM
zx92(7IankZ>!C(Zy}muC={>gLKWc3`#cL7~9T=<GKgR3ng4BG}$0_+LPkTebQ-CwY
z>|=R|@z^};QaDfdHI-N9^J(%O*vQD?vg(`^l`VI3!Q<)T+ir}|*S>uwi;GkrG9QfG
zJgP(Gdvog1J+jV3nlug-iTY)ZZ#Ivq%I}6MdL&iNCLepQ^Drb<ZLjiSaGxENCOtmE
z>4Qz)MTL1uvyz4W#lbH)O{JUj@`aU$UCpLq?(I1UHK+8&LHQ;qG=qn2Yrft=DbKrz
z^@-eHoZxeJJRZ$wb#@>v?Ui0>w}I4CR1%~7nhrp4e{@WI%YI6Gh=44MKK-fpxRU#`
zLhZUy>p%nL>vqEj-&9AvzvG+}ksvj&%-84zfm{7Ns&gdbo&7(uiN6l){t?uEuhy3*
z=OV{^9o<Z)<votf-^r@xXEOUc>Je!LDc*<&c7KPwfS<@kL_9A5`5)q)&d*)|I9BB+
z7X1f!M~c%Q=W%-9F-;TD0MrUq3zcIPf9m<~FzuI;|0Qm54SnT|;NPXzV)6F{THEM)
zZYh_B500FF5XTFIn|0=#p~9^%tj3takwuOfbM#~8UOk&5N@t_Rwr?+K@);$+H5q&s
z)*Ap*+Z8@w&ek-sdu%RQ#yB!)Gxp1)Mcz!FmrJsga*H3ZAFar>mHWGzxWb=(&Vw^|
z+@tTk=fz?f868qkb}0X?&L&s;eF|=wQNy$Gjpxvbf?IYU$)d<V*xjst$MXzwq<yrp
zQ3yMcKsE{r@l#oB?H#{zc}iE{^QGLO1E14WtE`1C;>jMlUA?$V^R#+SK_yo8s_iEz
z-kAQO)p4tY^Ew>`9?S|9;0mZi#jVv=rLkc0q@gy7)7rz0eMbB|j>;$EKgzeR^goM>
zS1qg34>%jr)#0$=e(+|f(wtoL1B0GrSB4#pQz2Msz2fTK@^N_inJGRl#fCO3)0>|V
z6(Il8Sq;tr1oK2G+nO;?;z{m?drTNLWt>AHG&dVD-Hyk;GFY7j!8E*~60`m+DU6pc
zN2amYxy=RKKpIx?>g;ujHyx@kj+9*&_oz-Ch|{W7xG0g6x4Wyo!g0gyV0^+Tqio$Y
zR3N*jV7HsOZd>?y_tPNLkJXQlYylDPfNyxYUbf&TX-y{PEq57)@qA@1RHsXO;@(8&
zwb@j%ZhvEDYKiHyR2q9IfvS8^<b74Oao};vN3-VJXP}XwHe%4-A(9Fp^#5Vu4rcx*
z67d`NDI|;nynnp`A%`;jjS2z$e?6mwGVQ<E`HQ{)GQSCf>7o1pFF-uZr(mBve<w%^
zUeMI8aJ-b$0^dJ#En)*u_)8T9RD=SO(eULsC%`Xq;~~#sm@U~WtsAB%_5CV>Jq}(<
zc++ZP2^{)ey8`L;5FiE+JC2LiymEf2#rXlFAf6xc`oi<rv8NTa=OnhW4jpj0U=v8H
zulE@O@udNUA#e-~(SCBJh?=$2E{$r`S;R)yO4+SpJ*Qz|x_za2De9b#16Y`Bb?c(;
z5%K)><Q%>DPos8-uXVB;y!~{W<!DR!n)|e(2&@eZg)8zT72>2Tf<5>-@sMtk7DQGU
z2_7L{4p7m2fB66q^I9ahm3XTeAQTr9?eR}XAHT?;DpXZjRax;g5CHfACx|cXC}kMQ
z!Mv1Y6zuV9H$luqg3EED{pxLt>j}8D{{KSTKfe%+Ap5sb3R!;KQY5~~{W0)A6xt@Q
z*|s$|kL_aMH}G<ymG1Hf?9Zn8cQ-M}ms%?emmj=y>@lxR$}Zz{q5<rB!6n~>)PrUY
zx^li+&Dk#mTOL1Q%0wI8NjWii_?{c_u-c$+r9sMda5ieWrZjU`6<*+C(ah8N)gryZ
z_rx$G^}_)k2I}iE9=?#F@>qURM`I_J*4GKL20Ka7=3IN3s_N#Q?|q@Ygp!Bz$xjR$
zk&{7Sm<2dXx8hQGRs;)m!CUrGQQy#46(S>5EkjkNA0wW(ZQs5ZW>pc+%sW4U^JDz@
zUOO_;$s?>T_2e;JLbp8|=a*71Y3d$oj+;7@n!ay!A;)Ovp9FCBzR`aoSn4C4&mLgG
z{!A3|;q094;`?(M8sWi6yk>r$9!Ea%krB0tv5@s#^;2sH{JUpxo{vd$S{u>lI!-Cj
z^<EOtI=`4-6Qf8YzRSDNIXfNVwZcNsq(QUwJ$s)hjX&L=d!35mX2L8~-6?14n9%MU
zf|t6LGVcYwF6fccrj#hWM!Zdf=xtt($P<a_T$OWK_v;~=P=@?+dk#_Sf#e`}0~C65
z`{B$o%Y5OQ?p^#wq10EZXF0C@X|;mQNjDj(WiRW^>cVfsu8cH!H+l458<xyXdj)dn
zJY`m=*gWdp99`vdc*kX19m_6xO+)Lm6s>V}kMqaSYi$}H+OFjF;V*(t(GKCxlKx=A
zp4t4z-%I@Y`eT7V7WiX<KNk37fj<`bV}U;w_+x=T7WiX<KNk37fj<`bV}bwJ0w3)`
zWEU>CZX0sEfCUe(9uF6-%%1OBvJ)^swL0-7c}Z(Dt?l^5vVM|e@(<(2S%ls7+<i{C
zY}j`Kr+37aj-D@{*;BTKTQJLOlEWl~>%h5#oQlrb-IUmKLa(<wX49kEkF^{!s7m`<
zvJBcZIN2Gt$!v2EUNYdf)*+yCw6lW$*(OJJ-NB0xpB~d1ohO2`l6UF}H!3yjD7iQ!
zvsugBWJ<=aiPzj$!ynjG-T|}%edzss4<SEE$iC9O(Z4z`aYnJYfV<W{#EMs}H)1|Z
z1m<y#e7yc8c#X08I7C(9IG|d>@etaQ`)M9G+GA9M>SPa0Z#t1YEFd<Yqho}QPVwW9
zWA&dV8jQxr$e#G$K%C;FACR%7*g6>*eYCN@j<qM@<rN3iwaHTt!@bsaLg!u2bzkze
zN|U;jt$P5OW2|^F%}9qu4A7y!NMYF}S`lqtX;U?(`+(exT`(m+{>y!GCJtS5ibe8C
z-HCMY*$dp3Dwj;hO_j1MANF<$o<j*0^angmIKShVoSdf#5x!Y9tUVvH<lwb48M+3y
zI5kDr|IJxu{obu9rK4w*YALu))48U53e@&8kF;uSCUl!q7D&Y<*57byZhusNxi*#3
z#U`S{_6)!8FkGm^Ph`SN+#{IBqj~o#!X_+`VGh+><hsmZugT4{y4N#?D-*mo$M<k`
zdDN8d(BS5|%O9q9K2|>E(sC)GdXl~>0z)9~fA}CFk7Z!?R$Jtlyx0sc*B5LlAQaj?
zrnybkM|}49=@qM}H@Cd<ZNqB6WQU}Me7<yVcl@5X2#4YAI~-1j=`iR8_;5jgTRCkt
zy#{heDof_w!FFz)MCDauUx&)u25u6`F9oeNc23TClt`ppd17y}sulizYqCHK>$dw`
zsCm0FJgY<}T<N$=`h7LRB<7Q|(FQpB==IKqNo(OeF&$51+cRV$mX30XR+zFN|1SbJ
z>I=QYPPlr}+gFF|y}31Rz<zZWd;Tpr1KKl4&_>b`#v`vB4=%WrDAA5(NKknvU3Q>H
z8T@jK^^{rJq;S0Gn6D+2RVq*=PSm5>=lx?gx1chi{w|p;v8aL0L2s=Ok4uldL%~{j
zGUcy%TuOISrh$z&_;)Uj58vV+E0J-Q))z2*u~b;0M5p_?s6IA>?`px5C#GRHCleO@
zWhHJNUrrxP&F2>19Bg=HrNPURHX5yItoO-OM!jl*-l=}7T)Nv{1NTz;VMWgs#S$pM
z`{wPVNsN|8wi|t{ltiy^|Lj=Bk(FC4y7lZ7T?gKIMh=Ijimq5sn~Vm4MJd;s_=ZDJ
z&ma}+i=PLbSGW1;a4ZJ;J*`=9{PvWFCSbQ@&QzEfbt6w0iZ*XsY`%<uigdMd%LSes
zSGhE;-Wk*HAUUbp{c={V)6Rm5P3w-z*xf3mZAEJ}UbASR#osSA6FfMQg?w{;yJ947
z?N;SW!A2h&J4e3onYY1M*ETK~mZQ4*v!nryR{i;{(rXu~=Ny+EE@*L}-z2<S&uUAS
zZv8CSo#hx(`X-Jrdr)cmNWg~mDhHdxn-#gxGq)V~JRA>vdZF}`CuZ#K`IOf5z_M!<
z_%DvAhmUBEh<5cM5`EtF&5RyY%(4&}y(kyj^(=rBl_+e2OPi&D543SsW;}V0d*s0Y
zsh;zxtK=I^JoO<?q%+3EA^C-!fPm_AxK^F^NI?Z_o`1+~O4^{bG!J{3(QRt-aq`}<
zp_@aj4@L)s@n4``F}E>Em#b^&g;Ztuc4uW3f}gWTIttOaA!CO_4l_-G2J)|Y#fxmR
z>P=j9xU>=myYi;b3xm>Lv{4OGw9ffbYSV_U6z)z*WNX>x_Uiw3gMFHVfi=unMWo@g
z%6!L%*1F884*rF+?Rch{7)`Hep<T}nnt+{^cH<LT$i|$&;Pl2+M4%UWK{A=`IMTRO
zE_f?`SZS=6?Alba>5)nHIox?a9&I7fZp8<RMx$SXywdw^F@ga$l1uNzw9pQ7pEf&V
z%rQ@SlFSPtUSA~C7*7XYJ$@zFpi?-M?P^fde3@p|)-KIf=B${`4#ie|#Kd!oQ|ryI
zZajqsOpoqdK69e{rPZZkWoN$ja|j%Yh40q0aQi$rgJz>^omDyq2olrCDa*c|j4CmM
zGZU|F<peZ!UzqPYf7uCOdiip%KBoHV(2k(7!#BSnA6#gczw78OX#MkDBiKlc-U~Z3
zBdeFUPwOl^_F95BZg6vQw$Fckd_mJTSRm)f#->)dE800xJ~wRPzNCxofk|*Kz-`(T
zh@fWC3tRUODPy{_R@55#)@|c_>gT9sdYrrypD^o{Cr*$?YN^Ya54qtZokB<N;!=i<
zoFKzm$jpuF$<uq!CABx(lvrP#_`F@8BlLC1tFxvgAASu;jrj8ROWdLA<rFswetK>?
z`*=rZomhv${Ik?W@wbygc7fgdtgiIZRBNzzg>RnZL0=|aU#ur<wtf7VjX1E<dn%78
z`a#Rr-3Yf@i=J{V=%MM>_nTG^+tz!NkF3wTq|{%Q42*Gz%3aIn3)#K4vE+PbCE|g4
zXJBrfuMF&5N!+cXc<!h;5Pf`cr<|Jy+X+e7_QIV{&E(7hQN`U6cKRKhkK*S?_+<xp
zZV=vg)z@X$o$3K3Ml89HKI$BjxYNq`jzXV1M>{!Wb4a1!%R<L|CMUeO=ao|%Z^u<W
z8vI)~KE%=>LyOr_N+>6vN!C~w1@Oknj`A(nXmgZjzO92L8<np$1(d2i^1#r+ip)nk
zLyI<yyvLDJdR-7#9s0AT<&@G39o{|PghPDkMX&3=fWh6G!(@)BwEMX_yavTtTnKhV
z%>%tIbdPc?bmJme=p~{pMsMhIaLDPJEL|<X$qJ(tH6Oiebky78HeVr2%FI>;L7IE*
zeTDEnYiRRB4HJH@h6tJMmqi+!eRmk&cj%1GsxDs7idQ}EKAV9Jmn$W+5M*ap-ja~&
zvACM$PA(n6$I_sjR&>A_%<9FW%zZ*9_f@WFysQ&gN%CSBBbcEutI5Po_MJ~eh2aDw
zwgYP&Pf4k3i{bZ(sf}I?w4@WJ(z%ueo>1;)6CR8ihze{!Ei7H!6v)lN%wV9@?Q)}?
z{aRzb(v@)(R5ZIuPb?PYLH6km4JYp8InERf+R%3#a;fa>;t&R5TOaPSBH8IJ?WPU$
zLg%T7O0V|Ty2^sG%{CfAg>#oGpS5BVX)kt4`LdwV1eC{JWm7tRo;Pm_rA|wbd(srs
z_xHJ!iovq(hX&Y(typx18pee2^FBKXR&XTL6ui$3S9)z&u5ha;r}9mztL7Enx9q-*
zhi@NM<!4tPrD~^VuClmIS<E<K0lv3c_{OSCwpFbs&uw-sge$*=iE)r8Y`#Y8u0*m(
zfeBP4g{Lw<jGTM2K$36OnxXasGeZK`SsOAwNCU_<x1*Qow03A8tNoKF1We0obsRKN
zF?m|_#ZK64@~*n++iFepq{JR)N@Iew%-R=omZjPq^_#ONJ*|%wn|P6rleMFm7xhkR
zZp0Pwb$;Y-+e}v9`*?-bQ1?n_!sYaQt2D5FsD#{>e^K2ToLF_=m&9xnlVQ8_OT(#*
z0p@r!=1A*nO*CK*OQweyu2n787oV$e`Fm<L{0ns5_fz#;Xy)3a82co7&P+dP<*AHl
zNPnc|JE82<u672Kgi@n_D|cfW41JTq8V%0w_{tUI#6Ohh+{XEFy7~O)>h*K?q-8&L
zYDM&Pe9+MRdMm{iLGCSm_R2**8k>>OYT7!#Cr(19wJn)iX4mRQrFCmSk?!SITa$f5
z;I8U6Y2VV_S5n-SJldzjw`?T+uO42z-Ix1rDD~p`2T}F7VjA6JwX-JT{;X;vG1P0U
z`R9(kqotSZTibIq*BqQ>J0kf4N4;$7lA9UYdDRnfcP5nzI8|k)u=(=Lu_64|kp-Tr
zu6!_vnWw3RYQCD%{>V86O}_$wTPBL8#Rs&zb!x%D=XK*uUHxP<3~V{z2Qw%SKhx>J
zEFxHQXN|`BdDO8izb|gRKtv^4MRQ`N?AWcZm0X&VVJ}7!W}cQsQzy|XoH?NKu4t}f
zIGj5edV^u6U?{TwoCoG^a(c75wB5m$>E^V|UO2t#YN}ax)f4*N8n&wx6TUvH8sFaI
z`aH~N=(N;!$iBV0;4{rZzE0fP4<}$jj_(ZEr=IK_OX-h)S;5kyId**UtmV@=z7pQ>
zPu_Bk<KhL04pu&$A`HPrT<y1qr23cE2Rb`;3}HoltC*yj48*6LJ=U<=;!SDhS^FB1
zW~L0r`vMNdH%A_+guE4&PEU!I^gAN<<^yfF>nr&n*0$i0v#!XfgR=THqGy^w;p^Ld
z$#S$NbcBVsNwruR>oP}3%graEUuRZ|?vXXknZ(G*X$GdR?W`ok+e*cLepYxhAh7YW
zw5zPdYD$^0k8dj530~eAS1xwPm$A21^$zk8l4L?1ho900*5s;5dnC#8jJ>*HI@WOr
zA@y~9{(ShS%X``3!mDa1$GFp8_uv9mVT9o1;j~31B&$lt$?OWeQBUjj*u_&uX}QUH
z%Fa9A#;L=`pM6O;FWo!r3493I`dsC#zG3jiF3s4?&A_@B?Nc8Cq0CbDZU|*iX=uN3
zjWD4;$*<2LI&}8KjN|IP@VV;`YUBj)e)V~julJUMhrb1koTKX5Bg-gW`GkHplSg88
N#>Y<TSL?b&{vV~MJQDx_

delta 455
zcmV;&0XY7Pg8|<IkRyKp32;bRa{vGi!~g&e!~vBn4jTXf0g*{WK~!jg?V3Fj0wD}W
zvyPpfN^hmL-bzoUwKhgEf&}tKSjJcGtdU2;EPq6UFnI*s94@!qJLmlx`roi%n#QL<
zNSOjy8lR$8s#?TDf~k=y{(+}}q(rDl<d+hRRz@w-LW0rAs6>BSN-#N@tVj<M%r}{@
zB0WhkDVd}QLgKVreLUM9uhy_pnW%_WA|@cQ3Q3uzDVjhdAm2q~h$xbg+H90aNNQ!m
zth|Y|kYKDb(9((#HV`44Vqp!CYTWjC{pjV`vs@f4PZ8udBUdJ<0Z#O4w<#m&QnAD{
zmzG4^+sLdCJw$(coQjmNIb3e=jI;tSqOEiE_%ey0>)aC0rL=Or?eSrph<s<e+Aq5`
zyY5pI&uK{rq_nKPi5P3JF;d$Y_<98SQT)XUG32~oPcCDG8|k%XkKsDly&4?@vO;VL
zuMq!pt=@p`qO>5ni^9x7MsCoJTUt!dSyAu(GCj%^@5VnfJ;_v`k1##Rm`|*jA<ht)
xAx?FfA<o%DW`FY`WQe;cl3CvlO3~uJ)*bK{$YpjyLs9?$002ovPDHLkV1hNG(i#8&


From 8e65ddcbe3b47dc28057437cd3e7cfe30e31e665 Mon Sep 17 00:00:00 2001
From: Paulo Castellano <paulo@castellanos.llc>
Date: Tue, 11 Aug 2026 11:55:15 -0300
Subject: [PATCH 47/47] docs: record durable rules for exhaustive Platform
 matches and per-platform meta validation

Captures two gotchas discovered while building the Google Business
Profile integration, so the next platform addition finds them instead
of re-deriving the same bugs.
---
 .ai/rules/index.md          | 8 ++++++++
 .ai/rules/social-account.md | 9 +++++++++
 .ai/rules/support.md        | 9 +++++++++
 3 files changed, 26 insertions(+)
 create mode 100644 .ai/rules/index.md
 create mode 100644 .ai/rules/social-account.md
 create mode 100644 .ai/rules/support.md

diff --git a/.ai/rules/index.md b/.ai/rules/index.md
new file mode 100644
index 000000000..3a16c9162
--- /dev/null
+++ b/.ai/rules/index.md
@@ -0,0 +1,8 @@
+# Project Rules Index
+
+Before planning or editing, find the row whose globs match the file's path and read that rule file.
+
+| Applies to | Rule file |
+| --- | --- |
+| app/Enums/SocialAccount/Platform.php | .ai/rules/social-account.md |
+| app/Support/PostPlatformMetaRules.php | .ai/rules/support.md |
diff --git a/.ai/rules/social-account.md b/.ai/rules/social-account.md
new file mode 100644
index 000000000..2b28774d4
--- /dev/null
+++ b/.ai/rules/social-account.md
@@ -0,0 +1,9 @@
+---
+paths:
+  - app/Enums/SocialAccount/Platform.php
+---
+
+# Social Account
+
+## Adding a platform: grep for exhaustive Platform matches beyond the known touch-point list
+Adding a new Platform enum case breaks any `match ($platform) { ... }` elsewhere in the codebase that enumerates every case with no `default` arm — these throw UnhandledMatchError only at runtime/test time, not statically. Known example found the hard way: `app/Services/Media/MediaOptimizer.php`'s per-platform image optimization settings match, which isn't part of the "usual" platform touch-point list (Platform enum, ContentType enum, config, PostPlatformMetaRules, publisher, controller, frontend registry). Before considering a new platform done, run the full test suite (`php artisan test --compact --parallel`) — a missing arm surfaces as a clean, unambiguous UnhandledMatchError failure, not a silent bug.
diff --git a/.ai/rules/support.md b/.ai/rules/support.md
new file mode 100644
index 000000000..a26e69c8f
--- /dev/null
+++ b/.ai/rules/support.md
@@ -0,0 +1,9 @@
+---
+paths:
+  - app/Support/PostPlatformMetaRules.php
+---
+
+# Support
+
+## Never use a cross-field Laravel rule (required_unless, required_if, etc.) for a single platform's conditional meta field
+`rules()` is shared by every platform via `platforms.*.meta.*` wildcards. Rules like `required_unless`/`required_if` are Laravel "implicit" rules — they validate even when the field itself is absent from the request. Adding one scoped in spirit to a single platform (e.g. `call_to_action.url` required_unless action_type is NONE/CALL, meant only for Google Business Profile) breaks every OTHER platform's create/update through web, API, and MCP, because their requests never send that field at all and the implicit rule still fires. The correct pattern (already used by Pinterest's `board_id`, Discord's `channel_id`): keep the field's `rules()` entry unconditional (`sometimes|nullable|...`), and enforce "required" semantics only in `requiredMetaViolation()`'s `match(true)` block, which is evaluated per the resolved `Platform` of the row being checked. This bug shipped once (fixed in commit 8887b3f3) and broke Pinterest/Discord/TikTok post updates — the task reviewer that approved the original `rules()` entry didn't catch it because it only reviewed Google Business's own test coverage, not sibling platforms'.