已配置服务账号权限，Google Analytics 4 PHP库仍返回空属性列表？

• API版本不兼容：你使用的management_webproperties->listManagementWebproperties属于Google Analytics Management API v3，这个接口仅能获取Universal Analytics（UA）属性，完全不支持GA4属性。这是返回空列表的核心原因。

• 改用GA4专属API：要获取GA4属性，必须使用Google Analytics Admin API的PHP客户端库，调用properties.list方法。示例代码如下：

  use Google\Analytics\Admin\V1alpha\AnalyticsAdminServiceClient;
  
  // 初始化客户端
  $client = new AnalyticsAdminServiceClient();
  // 构造父资源路径，格式为accounts/{账号ID}
  $parent = "accounts/{$accountID}";
  // 调用接口获取GA4属性列表
  $properties = $client->listProperties($parent);
  
  // 遍历输出属性信息
  foreach ($properties as $property) {
      echo "属性名称：" . $property->getDisplayName() . "，属性ID：" . $property->getName() . PHP_EOL;
  }
  

• 权限二次确认：

  • 确保服务账号已被添加到具体GA4属性的用户列表中，授予Viewer及以上权限，仅账号层级的权限可能无法访问GA4属性。
  • 检查服务账号的OAuth2密钥文件是否正确，确保使用的是配置GA4权限的那个服务账号的密钥。

• 账号ID格式校验：确认传入的accountID是纯数字字符串（如"123456789"），不要添加accounts/前缀或其他符号。

内容的提问来源于stack exchange，提问作者atik