Google Analytics Admin API PHP 客户端库安装与实战指南skills29 skills 项目【免费下载链接】skillsAgent Skills for Google products and technologies项目地址: https://gitcode.com/GitHub_Trending/skills29/skills本指南围绕 skills29 skills 仓库中 php.md 文档系统讲解如何通过 PHP 与 Composer 安装 Google Analytics Admin API 官方客户端库、完成 Application Default CredentialsADC认证并编写可运行的账户摘要查询程序。读完本文你将掌握从环境准备、API 启用、凭据配置到AnalyticsAdminServiceClient初始化的完整链路并理解该 Skill 在自动化管理 GA 账户、媒体资源与数据流时的典型应用场景。前置条件PHP 8.0 与 Composer在动手之前需要确认本地环境满足以下三项要求前置项要求说明PHP8.0 或更高版本客户端库基于现代 PHP 特性构建低于 8.0 无法运行包管理器Composer用于安装依赖与生成自动加载器autoloader认证Application Default CredentialsADC通过gcloud auth application-default login在本地生成如果终端中找不到composer命令需要先引导用户安装 Composer 后再继续安装包否则后续的require步骤无法执行。同理如果gcloud命令不存在应先在系统上安装 Google Cloud CLI因为 ADC 的生成、API 的启用与验证都依赖它。安装通过 Composer 引入官方客户端库在项目目录下执行以下命令安装官方 PHP 客户端库composer require google/analytics-admin为什么需要这一步Composer 会自动拉取 Google Analytics Admin 客户端库及其身份认证依赖即google/auth等底层库并生成vendor/autoload.php自动加载器后续代码只需require该文件即可使用所有类。这条命令同时会把依赖写入composer.json与composer.lock保证团队间依赖版本一致。[!NOTE] 关于安装的完整细节可参考官方 PHP Analytics Admin 仓库的安装章节本 Skill 的 php.md 中保留了该外部链接入口。安装完成后验证自动加载器是否生成ls vendor/autoload.php若文件存在说明安装成功可以进入下一步编写代码。使用前准备启用 Admin API 并配置 ADC 认证安装客户端库只是第一步。客户端库在运行时依赖两个云端前提Admin API 已启用、本地具备 ADC 凭据。1. 通过 gcloud 启用 Admin API在 Google Cloud 项目中启用analyticsadmin.googleapis.comgcloud services enable analyticsadmin.googleapis.com --quiet为什么需要这一步启用 API 可确保你的 Cloud 项目获得管理 Google Analytics 配置所需的配额与权限。启用后可验证状态gcloud services list --enabled --filteranalyticsadmin.googleapis.com2. 生成 Application Default Credentials在终端中运行以下命令为本地环境生成 ADC并附带所需的 OAuth 范围gcloud auth application-default login --scopeshttps://www.googleapis.com/auth/cloud-platform,https://www.googleapis.com/auth/analytics.readonly为什么需要这一步该命令将 Cloud Platform 与 Google Analytics 只读范围写入本地 ADC 文件客户端库创建实例时会自动读取这份凭据完成请求鉴权。[!NOTE]配置变更相关任何会修改 Google Analytics 账户/媒体资源配置的方法如创建数据流、设置数据保留都需要额外授予https://www.googleapis.com/auth/analytics.edit范围。因此若你的脚本涉及写操作请在登录时把该范围一并加入或对 ADC 进行相应补充。快速开始用 PHP 列出账户摘要确保引入 Composer 自动加载器后即可初始化客户端并调用 API?php require_once __DIR__ . /vendor/autoload.php; use Google\Analytics\Admin\V1beta\Client\AnalyticsAdminServiceClient; use Google\Analytics\Admin\V1beta\ListAccountSummariesRequest; // 初始化客户端。自动使用环境中的 ADC 凭据。 $client new AnalyticsAdminServiceClient(); $request new ListAccountSummariesRequest(); $accountSummaries $client-listAccountSummaries($request); foreach ($accountSummaries as $summary) { printf(Account: %s (%s)\n, $summary-getDisplayName(), $summary-getName()); }逐行拆解这段代码的要点require_once vendor/autoload.phpComposer 生成的自动加载器必须最先引入否则所有Google\Analytics\Admin\V1beta命名空间下的类都无法解析。AnalyticsAdminServiceClientAdmin API 的服务客户端类位于Google\Analytics\Admin\V1beta\Client命名空间下无参构造即从环境读取 ADC 完成鉴权无需手动传递密钥。ListAccountSummariesRequest请求对象。listAccountSummaries返回当前用户可访问的所有账户及其子媒体资源的摘要信息。输出格式getDisplayName()返回账户的显示名称getName()返回形如accounts/123456的资源名name。从仓库结构看本 Skill 同目录下的 SKILL.md 明确说明v1beta是 Admin API 最稳定的版本这也是 PHP 客户端默认使用的版本。若需要体验最新特性可考虑切换到v1alpha版本。深入Admin API 能做什么根据 SKILL.md 的说明Admin API 为 Google Analytics 账户与媒体资源配置提供编程式访问典型用例包括运行数据访问Data Access报告创建账户摘要Account summaries管理、新建账户provision搜索账户变更历史事件管理与创建媒体资源properties管理媒体资源数据保留设置管理转化事件conversion events与关键事件key events管理自定义维度与指标custom dimensions and metrics管理数据流data streams并配置 Measurement Protocol 密钥管理 Firebase 链接与 Google Ads 链接v1alpha 专属能力以下能力目前仅存在于v1alpha版本的 Admin API 中PHP 若需调用需切换到对应的V1alpha客户端类管理账户与媒体资源的访问绑定access bindings创建与管理汇总媒体资源rollup properties和子媒体资源subproperties确认用户数据收集acknowledge user data collection修改媒体资源的归因、数据保留、Google Signals、报告身份与用户提供数据设置管理 AdSense 链接、BigQuery 链接、受众audiences与渠道分组channel groups管理计算指标calculated metrics管理 DisplayVideo360Advertiser 链接、扩展数据集expanded data sets与报告数据标注管理 SearchAds360 链接管理数据流的事件创建规则管理 iOS 数据流的 SKAdNetwork 转化价值 Schema为 Google Analytics 媒体资源提交用户删除请求多语言对照PHP 客户端在 Skill 全家桶中的定位本 Skill 为每种主流语言都提供了对应的安装参考文档PHP 是其中之一。以下是各语言包与参考文档的对照表语言包名参考文档Pythongoogle-analytics-adminpython.mdJavacom.google.cloud:google-cloud-analytics-adminjava.mdPHPgoogle/analytics-adminphp.mdNode.jsgoogle-analytics/adminnodejs.mdGocloud.google.com/go/analytics/admin/apiv1betago.md.NET / C#Google.Analytics.Admin.V1Betadotnet.mdRubygoogle-analytics-admin-v1alpharuby.md各语言客户端虽然命名空间与语法不同但使用模式高度一致安装包 → 引入自动加载机制 → 无参初始化客户端自动走 ADC→ 调用listAccountSummaries等 RPC。以 Python 为例python.md 中的示例还额外展示了如何遍历每个账户摘要下的子媒体资源property_summaries这是 PHP 示例可进一步扩展的方向——只需对$summary调用对应的属性摘要 getter 即可获得同样的两级遍历效果。[!IMPORTANT]给 Agent 的强制性指令当用户选定某种编程语言时应读取references/目录下对应的客户端库安装参考文档即上表中的各.md文件以获取该语言专属的安装命令与示例代码。常见问题与排查思路composer命令找不到先安装 ComposerPHP 官方推荐方式再重新执行composer require google/analytics-admin。运行时提示凭据缺失确认已执行gcloud auth application-default login --scopes...并检查 ADC 文件是否存在于本地默认位置。analyticsadmin.googleapis.com未启用运行gcloud services enable analyticsadmin.googleapis.com --quiet并用gcloud services list --enabled --filteranalyticsadmin.googleapis.com复核。写操作被拒绝403/PERMISSION_DENIED检查 ADC 登录时是否包含https://www.googleapis.com/auth/analytics.edit范围只读场景使用analytics.readonly即可。命名空间解析失败确认在代码顶部执行了require_once __DIR__ . /vendor/autoload.php;且 Composer 安装成功生成vendor/目录。总结本文以 php.md 为核心完整覆盖了 Google Analytics Admin API PHP 客户端库的安装、认证与首个查询程序的编写全流程PHP 8.0 与 Composer 前置条件、composer require google/analytics-admin安装命令、gcloud services enable启用 API、带 OAuth 范围的 ADC 登录以及基于AnalyticsAdminServiceClient::listAccountSummaries()的账户枚举示例。配合 SKILL.md 中的用例清单你可以在此基础上进一步实现媒体资源管理、数据流配置、转化事件管理等更复杂的自动化任务同时依据实际写操作需求动态扩展analytics.edit授权范围。【免费下载链接】skillsAgent Skills for Google products and technologies项目地址: https://gitcode.com/GitHub_Trending/skills29/skills创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考