想象一下，你是一家连锁餐饮企业的老板，在全国各地拥有几十甚至上百家门店。每一家门店都在 Google My Business (GMB) 上有自己的页面，你需要定期发布最新的促销活动、更新营业时间、上传精美图片，并及时回复顾客的评论。如果这一切都依赖人工操作，那将是一个巨大的工作量，不仅效率低下，还极易出错，导致信息不一致，甚至错过重要的营销时机。你是否也曾为此头疼不已，渴望一种能够解放双手、实现自动化管理的解决方案？
幸运的是，PHP 开发者们可以通过 Composer 这个强大的依赖管理工具，结合 spotonlive/php-google-my-business 这个库，将 GMB 的管理工作变得前所未有的简单和高效。
Composer：你的 PHP 项目依赖管家
在深入了解如何管理 GMB 之前，我们先来回顾一下 Composer 的核心价值。Composer 是 PHP 的一个依赖管理工具。它允许你声明项目所依赖的库，并自动为你安装、更新这些库。这意味着你不再需要手动下载、复制粘贴各种第三方代码，Composer 会为你处理好一切。它不仅让项目结构更清晰，也大大提升了开发效率和代码的可维护性。
spotonlive/php-google-my-business：连接 GMB 的桥梁
spotonlive/php-google-my-business 库是对 Google 官方 My Business API 的一个封装，它提供了一套简洁易用的 PHP 接口，让你能够通过代码与你的 GMB 商家信息进行交互。无论是发布新帖子、获取门店数据洞察，还是管理评论和问答，这个库都能助你一臂之力。
立即学习“PHP免费学习笔记（深入）”；
安装与集成
要开始使用 spotonlive/php-google-my-business，你只需要通过 Composer 简单地将其添加到你的项目中：
composer require spotonlive/php-google-my-business
安装完成后，Composer 会自动处理好所有依赖，你就可以在你的 PHP 代码中 use 相关的类了。
实战：自动化发布 GMB 帖子
假设你每周都有新的促销活动需要发布到所有门店的 GMB 页面上。手动操作费时费力，而通过代码则可以一键完成。
首先，你需要完成 Google API 的认证授权（这部分通常涉及到 OAuth 2.0 流程，并获取到访问令牌，它是使用 Google 服务的通用前提，这里我们假设你已经配置好并拥有一个 $service 对象）。
use Google_Service_MyBusiness_LocalPost;
use Google_Service_MyBusiness_CallToAction;
use Google_Service_MyBusiness_MediaItem;
// 假设 $service 已经是一个经过认证的 Google_Service_MyBusiness 实例
// 例如：通过 Google 客户端库初始化并认证
// 1. 构建帖子内容
$post_body = new Google_Service_MyBusiness_LocalPost();
$post_body->setLanguageCode('zh-CN'); // 设置语言
$post_body->setSummary('本周特惠：所有饮品买一送一！'); // 帖子文本
// 2. 添加行动号召 (Call to Action)
$call = new Google_Service_MyBusiness_CallToAction();
$call->setActionType('LEARN_MORE'); // 行动类型，如 'LEARN_MORE', 'SIGN_UP', 'BOOK' 等
$call->setUrl('https://your-company.com/weekly-deals'); // 链接到你的活动页面
$post_body->setCallToAction($call);
// 3. 添加媒体（图片或视频）
$media = new Google_Service_MyBusiness_MediaItem();
$media->setMediaFormat('PHOTO'); // 媒体格式：'PHOTO' 或 'VIDEO'
$media->setSourceUrl('https://your-company.com/images/promo_banner.jpg'); // 图片链接，注意大小和格式要求
$post_body->setMedia($media);
// 4. 获取你的 GMB 账户和门店信息
$accounts = $service->accounts->listAccounts()->getAccounts();
if (empty($accounts)) {
die('未找到任何 GMB 账户。');
}
$firstAccount = $accounts[0]; // 通常你只有一个主账户
$locations = $service->accounts_locations->listAccountsLocations($firstAccount['name'])->getLocations();
if (empty($locations)) {
die('未找到任何门店。');
}
// 5. 遍历所有门店并发布帖子
foreach ($locations as $location) {
echo "正在为门店: " . $location->getDisplayName() . " 发布帖子...\n";
try {
$service->accounts_locations_localPosts->create($location->getName(), $post_body);
echo "帖子发布成功！\n";
} catch (\Google\Service\Exception $e) {
echo "发布失败: " . $e->getMessage() . "\n";
}
}这段代码首先构建了一个包含文本、行动号召和图片的帖子对象。然后，它会获取你所有的 GMB 账户和门店列表，并遍历每个门店，为它们发布相同的帖子。这样一来，你只需运行一次脚本，就能将促销信息同步到所有门店，大大节省了时间和精力。
实战：获取门店数据洞察
除了发布信息，了解门店的表现也至关重要。spotonlive/php-google-my-business 同样可以帮助你获取 GMB 的数据洞察，例如客户如何找到你的门店、他们采取了哪些行动等。
use Google_Service_MyBusiness_ReportLocationInsightsRequest;
use Google_Service_MyBusiness_BasicMetricsRequest;
use Google_Service_MyBusiness_TimeRange;
// 假设 $service 和 $firstAccount, $locations 已经初始化
$request = new Google_Service_MyBusiness_ReportLocationInsightsRequest();
$request->setLocationNames([$locations[0]->getName()]); // 指定要查询的门店，这里以第一个门店为例
$actions = new Google_Service_MyBusiness_BasicMetricsRequest();
$actions->setMetricRequests(['metric' => 'ALL']); // 获取所有基本指标
$time = new Google_Service_MyBusiness_TimeRange();
$time->setStartTime('2023-01-01T00:00:00Z'); // 设置查询时间范围
$time->setEndTime('2023-12-31T23:59:59Z');
$actions->setTimeRange($time);
$request->setBasicRequest($actions);
$insights = $service->accounts_locations->reportInsights($firstAccount->getName(), $request);
echo "门店数据洞察：\n";
print_r($insights); // 打印获取到的洞察数据通过这段代码，你可以轻松获取指定门店在特定时间段内的各项指标，例如搜索次数、地图查看次数、网站点击次数、电话呼叫次数等。这些数据对于分析营销活动效果、调整运营策略具有非常重要的价值。
总结与展望
借助 Composer 和 spotonlive/php-google-my-business 库，我们成功地将繁琐的 Google My Business 管理工作自动化。这不仅仅是代码层面的便利，更是业务效率和营销效果的显著提升：
- 效率倍增：告别重复的手动操作，一键完成多门店信息发布。
- 数据驱动：轻松获取并分析门店数据，为决策提供有力支持。
- 信息一致性：确保所有门店的信息同步更新，提升品牌形象。
- 节约成本：减少人力投入，将资源聚焦于更有价值的业务活动。
- 易于维护：Composer 管理依赖，库本身提供清晰的 API，使代码更易于理解和维护。
除了发布帖子和获取洞察，这个库还支持管理评论、问答、媒体等更多功能，为你的 GMB 运营提供了全方位的自动化能力。如果你也正被 GMB 的手动管理所困扰，不妨尝试将 spotonlive/php-google-my-business 集成到你的 PHP 项目中，让自动化成为你业务增长的强大助力！
