如何通过Google Analytics Data API在GA4属性间复制自定义维度？

你当前使用的Google Analytics Data API v1仅支持读取数据和元数据，无法修改GA4属性的配置（比如添加自定义维度）。要完成写入操作，需要改用Google Analytics Admin API，以下是具体的修改方案：

步骤1：启用Google Analytics Admin API #

在Google Apps Script编辑器中：

• 点击菜单栏的「扩展程序」→「Apps Script」（已打开编辑器则跳过）
• 点击左侧「服务」→「添加服务」，找到并启用「Google Analytics Admin API」

步骤2：修改脚本代码 #

保留你原有的getCustomDimensions函数（用Data API获取源属性自定义维度的逻辑有效），替换addCustomDimensions函数为以下实现，同时调整相关逻辑：

function main(){
  const gaSourcePropertyId = '12345678';
  const gaDestinationPropertyId = '87654321';
  copyCustomDefinitions(gaSourcePropertyId, gaDestinationPropertyId);
}

function copyCustomDefinitions(gaSourcePropertyId, gaDestinationPropertyId) {
  const sourceDimensions = getCustomDimensions(gaSourcePropertyId);
  addCustomDimensions(gaDestinationPropertyId, sourceDimensions);
}

function getCustomDimensions(gaPropertyId) {
  const sourceDimensions = AnalyticsData.Properties.getMetadata(`properties/${gaPropertyId}/metadata`)['dimensions'];
  const sourceCustomDefinitions = [];
  sourceDimensions.forEach((dimension)=>{
    if (dimension.customDefinition === true){ 
      sourceCustomDefinitions.push(dimension)
    }
  });
  return sourceCustomDefinitions;
}

function addCustomDimensions(gaPropertyId, dimensions) {
  // 获取目标属性已有的自定义维度，用于去重
  const existingCustomDimensions = AnalyticsAdmin.Properties.CustomDimensions.list(`properties/${gaPropertyId}`).customDimensions;
  const existingParamScopePairs = existingCustomDimensions.map(dim => `${dim.parameterName}_${dim.scope}`);

  dimensions.forEach((dimension)=>{
    // 从apiName中解析出维度作用域和关联参数名
    const [scopePrefix, parameterName] = dimension.apiName.split(':');
    const scope = scopePrefix === 'customEvent' ? 'EVENT' : 'USER';
    const displayName = dimension.name;

    // 通过「参数名+作用域」组合判断维度是否已存在
    const key = `${parameterName}_${scope}`;
    if (!existingParamScopePairs.includes(key)) {
      try {
        // 构造自定义维度请求体
        const newCustomDimension = {
          displayName: displayName,
          parameterName: parameterName,
          scope: scope
        };
        // 调用Admin API创建自定义维度
        AnalyticsAdmin.Properties.CustomDimensions.create(
          newCustomDimension,
          `properties/${gaPropertyId}`
        );
        console.log(`成功添加维度：${displayName} (${dimension.apiName})`);
      } catch (e) {
        console.error(`添加维度失败 ${dimension.apiName}: ${e.message}`);
      }
    } else {
      console.info(`维度 ${dimension.apiName} 已存在于目标属性，跳过添加`);
    }
  });
}

关键说明 #

1. API切换原因：Google Analytics Data API专注于数据查询，而Admin API负责GA4属性的配置管理（包括自定义维度/指标的增删改）。
2. 维度信息解析：GA4自定义维度的apiName格式为customEvent:<参数名>（事件级维度）或customUser:<参数名>（用户级维度），拆分该字段可得到维度的作用域和关联参数名。
3. 去重逻辑：通过「参数名+作用域」的组合判断维度是否已存在，避免重复创建。
4. 权限要求：运行脚本的Google账号必须拥有目标GA4属性的编辑权限（如Editor角色），否则会返回权限错误。

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