如何使用JavaScript创建Google Analytics媒体资源并解决相关报错

架构老林

2026-9-24

问题修复方案

一、解决`Uncaught TypeError: Cannot read properties of undefined (reading 'analytics')`报错

报错原因

你在window.onload回调中直接调用gapi.client.analytics相关接口，此时Google Analytics v3客户端库还未完成加载，gapi.client.analytics对象未初始化，所以读取属性失败。

修复步骤

不要直接把创建资源的逻辑绑定到window.onload上，必须等gapi.client.load('analytics', 'v3')加载完成后再执行相关操作。
可以把insertProperty逻辑放到已有的授权成功、库加载完成的回调链路里，比如放在handleAccounts函数中或者单独的触发逻辑中。

二、解决403权限不足报错

报错原因

当前配置的授权scope是https://www.googleapis.com/auth/analytics.readonly，仅支持查询类的只读操作，没有创建新媒体资源的写入权限。

修复步骤

把SCOPES配置替换为支持写入的权限，调整后配置如下：

var SCOPES = ['https://www.googleapis.com/auth/analytics.edit'];

该scope支持对Analytics账户资源的增删改操作，完全满足创建新媒体资源的权限要求。

三、调整后的调用示例

你可以把创建资源的逻辑调整为如下形式，放在库加载完成的回调里执行：

// 加载Analytics库成功后再执行创建逻辑
gapi.client.load('analytics', 'v3').then(function() {
  // 确认授权成功后再调用创建接口
  insertProperty();
});

function insertProperty() {
  var request = gapi.client.analytics.management.webproperties.insert(
    {
      'accountId': '替换为你的真实账户ID',
      'resource': {
        'websiteUrl': 'http://www.examplepetstore.com',
        'name': 'Example Store'
      }
    });
  request.execute(function (response) { console.log(response);});
}