update_trigger

Instructions

Implementation Reference

• src/index.js:1449-1774 (handler)

  MCP tool handler for 'update_trigger'. Fetches existing trigger data, merges with provided arguments handling special logic for different trigger types (e.g., formSubmission, scrollDepth), preserves fingerprint, and calls GTMClient.updateTrigger to perform the API update.

  case 'update_trigger': {
    // 既存のトリガーデータを取得
    const existingTrigger = await this.gtmClient.getTrigger(
      args.accountId,
      args.containerId,
      args.workspaceId,
      args.triggerId
    );
  
    // 更新データを構築（指定されたパラメータで上書き）
    const triggerData = {
      name: args.name !== undefined ? args.name : existingTrigger.name,
      type: args.type !== undefined ? args.type : existingTrigger.type,
    };
  
    // カスタムイベントフィルタ
    if (args.customEventFilter !== undefined) {
      triggerData.customEventFilter = args.customEventFilter;
    } else if (existingTrigger.customEventFilter) {
      triggerData.customEventFilter = existingTrigger.customEventFilter;
    }
  
    // フィルタ
    if (args.filter !== undefined) {
      triggerData.filter = args.filter;
    } else if (existingTrigger.filter) {
      triggerData.filter = existingTrigger.filter;
    }
  
    // 自動イベントフィルタ
    if (args.autoEventFilter !== undefined) {
      triggerData.autoEventFilter = args.autoEventFilter;
    } else if (existingTrigger.autoEventFilter) {
      triggerData.autoEventFilter = existingTrigger.autoEventFilter;
    }
  
    // タグ待機設定
    if (args.waitForTags !== undefined) {
      triggerData.waitForTags = {
        type: 'boolean',
        value: args.waitForTags
      };
    } else if (existingTrigger.waitForTags) {
      triggerData.waitForTags = existingTrigger.waitForTags;
    }
  
    // バリデーションチェック
    if (args.checkValidation !== undefined) {
      triggerData.checkValidation = {
        type: 'boolean',
        value: args.checkValidation
      };
    } else if (existingTrigger.checkValidation) {
      triggerData.checkValidation = existingTrigger.checkValidation;
    }
  
    // タグ待機タイムアウト
    if (args.waitForTagsTimeout !== undefined) {
      triggerData.waitForTagsTimeout = {
        type: 'template',
        value: String(args.waitForTagsTimeout)
      };
    } else if (existingTrigger.waitForTagsTimeout) {
      triggerData.waitForTagsTimeout = existingTrigger.waitForTagsTimeout;
    }
  
    // formSubmission用の処理
    if (triggerData.type === 'formSubmission') {
      if (args.formId !== undefined || args.formClasses !== undefined) {
        triggerData.filter = [];
        if (args.formId !== undefined) {
          triggerData.filter.push({
            type: 'contains',
            parameter: [
              {
                type: 'template',
                key: 'arg0',
                value: '{{Form ID}}'
              },
              {
                type: 'template',
                key: 'arg1',
                value: args.formId
              }
            ]
          });
        } else if (existingTrigger.filter) {
          // 既存のForm IDフィルタを保持
          const formIdFilter = existingTrigger.filter.find(f => 
            f.parameter?.some(p => p.value === '{{Form ID}}')
          );
          if (formIdFilter) {
            triggerData.filter.push(formIdFilter);
          }
        }
        if (args.formClasses !== undefined) {
          triggerData.filter.push({
            type: 'contains',
            parameter: [
              {
                type: 'template',
                key: 'arg0',
                value: '{{Form Classes}}'
              },
              {
                type: 'template',
                key: 'arg1',
                value: args.formClasses
              }
            ]
          });
        } else if (existingTrigger.filter) {
          // 既存のForm Classesフィルタを保持
          const formClassesFilter = existingTrigger.filter.find(f => 
            f.parameter?.some(p => p.value === '{{Form Classes}}')
          );
          if (formClassesFilter) {
            triggerData.filter.push(formClassesFilter);
          }
        }
      } else if (existingTrigger.filter) {
        triggerData.filter = existingTrigger.filter;
      }
    }
  
    // scrollDepth用の処理
    if (triggerData.type === 'scrollDepth') {
      if (args.verticalThreshold !== undefined || args.horizontalThreshold !== undefined) {
        triggerData.parameter = [
          {
            type: 'template',
            key: 'verticalThresholdUnits',
            value: 'PERCENT'
          },
          {
            type: 'template',
            key: 'verticalThreshold',
            value: String(args.verticalThreshold !== undefined ? args.verticalThreshold : 
              (existingTrigger.parameter?.find(p => p.key === 'verticalThreshold')?.value || 25))
          }
        ];
        if (args.horizontalThreshold !== undefined) {
          triggerData.parameter.push(
            {
              type: 'template',
              key: 'horizontalThresholdUnits',
              value: 'PERCENT'
            },
            {
              type: 'template',
              key: 'horizontalThreshold',
              value: String(args.horizontalThreshold)
            }
          );
        } else if (existingTrigger.parameter) {
          const horizontalThreshold = existingTrigger.parameter.find(p => p.key === 'horizontalThreshold');
          if (horizontalThreshold) {
            triggerData.parameter.push(
              {
                type: 'template',
                key: 'horizontalThresholdUnits',
                value: 'PERCENT'
              },
              horizontalThreshold
            );
          }
        }
      } else if (existingTrigger.parameter) {
        triggerData.parameter = existingTrigger.parameter;
      }
    }
  
    // elementVisibility用の処理
    if (triggerData.type === 'visible' || triggerData.type === 'elementVisibility') {
      triggerData.type = 'visible';
      if (args.selector !== undefined || args.visiblePercentageThreshold !== undefined || args.continuousTimeMinMilliseconds !== undefined) {
        triggerData.parameter = [
          {
            type: 'template',
            key: 'selector',
            value: args.selector !== undefined ? args.selector : 
              (existingTrigger.parameter?.find(p => p.key === 'selector')?.value || '')
          },
          {
            type: 'template',
            key: 'visiblePercentageThreshold',
            value: String(args.visiblePercentageThreshold !== undefined ? args.visiblePercentageThreshold :
              (existingTrigger.parameter?.find(p => p.key === 'visiblePercentageThreshold')?.value || 50))
          },
          {
            type: 'template',
            key: 'continuousTimeMinMilliseconds',
            value: String(args.continuousTimeMinMilliseconds !== undefined ? args.continuousTimeMinMilliseconds :
              (existingTrigger.parameter?.find(p => p.key === 'continuousTimeMinMilliseconds')?.value || 0))
          }
        ];
      } else if (existingTrigger.parameter) {
        triggerData.parameter = existingTrigger.parameter;
      }
    }
  
    // youtubeVideo用の処理
    if (triggerData.type === 'youtubeVideo') {
      if (args.enableTriggerOnVideoStart !== undefined || args.enableTriggerOnVideoProgress !== undefined ||
          args.enableTriggerOnVideoComplete !== undefined || args.enableTriggerOnVideoPause !== undefined ||
          args.enableTriggerOnVideoSeek !== undefined || args.videoId !== undefined) {
        triggerData.parameter = [
          {
            type: 'template',
            key: 'enableTriggerOnVideoStart',
            value: String(args.enableTriggerOnVideoStart !== undefined ? args.enableTriggerOnVideoStart :
              (existingTrigger.parameter?.find(p => p.key === 'enableTriggerOnVideoStart')?.value || false))
          },
          {
            type: 'template',
            key: 'enableTriggerOnVideoProgress',
            value: String(args.enableTriggerOnVideoProgress !== undefined ? args.enableTriggerOnVideoProgress :
              (existingTrigger.parameter?.find(p => p.key === 'enableTriggerOnVideoProgress')?.value || false))
          },
          {
            type: 'template',
            key: 'enableTriggerOnVideoComplete',
            value: String(args.enableTriggerOnVideoComplete !== undefined ? args.enableTriggerOnVideoComplete :
              (existingTrigger.parameter?.find(p => p.key === 'enableTriggerOnVideoComplete')?.value || false))
          },
          {
            type: 'template',
            key: 'enableTriggerOnVideoPause',
            value: String(args.enableTriggerOnVideoPause !== undefined ? args.enableTriggerOnVideoPause :
              (existingTrigger.parameter?.find(p => p.key === 'enableTriggerOnVideoPause')?.value || false))
          },
          {
            type: 'template',
            key: 'enableTriggerOnVideoSeek',
            value: String(args.enableTriggerOnVideoSeek !== undefined ? args.enableTriggerOnVideoSeek :
              (existingTrigger.parameter?.find(p => p.key === 'enableTriggerOnVideoSeek')?.value || false))
          }
        ];
        if (args.videoId !== undefined) {
          triggerData.filter = [
            {
              type: 'equals',
              parameter: [
                {
                  type: 'template',
                  key: 'arg0',
                  value: '{{Video ID}}'
                },
                {
                  type: 'template',
                  key: 'arg1',
                  value: args.videoId
                }
              ]
            }
          ];
        } else if (existingTrigger.filter) {
          triggerData.filter = existingTrigger.filter;
        }
      } else {
        if (existingTrigger.parameter) {
          triggerData.parameter = existingTrigger.parameter;
        }
        if (existingTrigger.filter) {
          triggerData.filter = existingTrigger.filter;
        }
      }
    }
  
    // timer用の処理
    if (triggerData.type === 'timer') {
      if (args.interval !== undefined || args.limit !== undefined || args.startTimerOn !== undefined) {
        triggerData.parameter = [
          {
            type: 'template',
            key: 'interval',
            value: String(args.interval !== undefined ? args.interval :
              (existingTrigger.parameter?.find(p => p.key === 'interval')?.value || 1000))
          },
          {
            type: 'template',
            key: 'limit',
            value: String(args.limit !== undefined ? args.limit :
              (existingTrigger.parameter?.find(p => p.key === 'limit')?.value || 1))
          },
          {
            type: 'template',
            key: 'startTimerOn',
            value: args.startTimerOn !== undefined ? args.startTimerOn :
              (existingTrigger.parameter?.find(p => p.key === 'startTimerOn')?.value || 'windowLoad')
          }
        ];
      } else if (existingTrigger.parameter) {
        triggerData.parameter = existingTrigger.parameter;
      }
    }
  
    // その他のタイプのパラメータを保持
    if (!triggerData.parameter && existingTrigger.parameter) {
      triggerData.parameter = existingTrigger.parameter;
    }
  
    // fingerprintを保持（更新に必要）
    if (existingTrigger.fingerprint) {
      triggerData.fingerprint = existingTrigger.fingerprint;
    }
  
    return {
      content: [
        {
          type: 'text',
          text: JSON.stringify(
            await this.gtmClient.updateTrigger(
              args.accountId,
              args.containerId,
              args.workspaceId,
              args.triggerId,
              triggerData
            ),
            null,
            2
          ),
        },
      ],
    };
  }

• src/index.js:408-530 (schema)

  Input schema definition for the 'update_trigger' tool, defining parameters for GTM trigger update including IDs and type-specific configurations.

  inputSchema: {
    type: 'object',
    properties: {
      accountId: {
        type: 'string',
        description: 'アカウントID',
      },
      containerId: {
        type: 'string',
        description: 'コンテナID',
      },
      workspaceId: {
        type: 'string',
        description: 'ワークスペースID',
      },
      triggerId: {
        type: 'string',
        description: 'トリガーID',
      },
      name: {
        type: 'string',
        description: 'トリガー名',
      },
      type: {
        type: 'string',
        description: 'トリガータイプ',
      },
      customEventFilter: {
        type: 'array',
        description: 'カスタムイベントフィルタ（CUSTOM_EVENTタイプ用）',
      },
      filter: {
        type: 'array',
        description: 'フィルタ（linkClick、clickなどのタイプ用）',
      },
      autoEventFilter: {
        type: 'array',
        description: '自動イベントフィルタ（linkClickタイプ用）',
      },
      waitForTags: {
        type: 'boolean',
        description: 'タグの待機を有効化（linkClickタイプ用）',
      },
      checkValidation: {
        type: 'boolean',
        description: 'バリデーションチェック（linkClickタイプ用）',
      },
      waitForTagsTimeout: {
        type: 'number',
        description: 'タグ待機タイムアウト（ミリ秒、linkClickタイプ用）',
      },
      // formSubmission用
      formId: {
        type: 'string',
        description: 'フォームID（formSubmissionタイプ用）',
      },
      formClasses: {
        type: 'string',
        description: 'フォームクラス（formSubmissionタイプ用）',
      },
      // scrollDepth用
      verticalThreshold: {
        type: 'number',
        description: '垂直スクロール閾値（パーセント、scrollDepthタイプ用）',
      },
      horizontalThreshold: {
        type: 'number',
        description: '水平スクロール閾値（パーセント、scrollDepthタイプ用）',
      },
      // elementVisibility用
      selector: {
        type: 'string',
        description: 'CSSセレクタ（elementVisibilityタイプ用）',
      },
      visiblePercentageThreshold: {
        type: 'number',
        description: '表示割合閾値（パーセント、elementVisibilityタイプ用）',
      },
      continuousTimeMinMilliseconds: {
        type: 'number',
        description: '連続表示時間（ミリ秒、elementVisibilityタイプ用）',
      },
      // youtubeVideo用
      videoId: {
        type: 'string',
        description: 'YouTube動画ID（youtubeVideoタイプ用）',
      },
      enableTriggerOnVideoStart: {
        type: 'boolean',
        description: '動画開始時に発火（youtubeVideoタイプ用）',
      },
      enableTriggerOnVideoProgress: {
        type: 'boolean',
        description: '動画再生中に発火（youtubeVideoタイプ用）',
      },
      enableTriggerOnVideoComplete: {
        type: 'boolean',
        description: '動画完了時に発火（youtubeVideoタイプ用）',
      },
      enableTriggerOnVideoPause: {
        type: 'boolean',
        description: '動画一時停止時に発火（youtubeVideoタイプ用）',
      },
      enableTriggerOnVideoSeek: {
        type: 'boolean',
        description: '動画シーク時に発火（youtubeVideoタイプ用）',
      },
      // timer用
      interval: {
        type: 'number',
        description: 'インターバル（ミリ秒、timerタイプ用）',
      },
      limit: {
        type: 'number',
        description: '発火回数の上限（timerタイプ用）',
      },
      startTimerOn: {
        type: 'string',
        description: 'タイマー開始タイミング（timerタイプ用、例: "windowLoad", "domReady"）',
      },
    },
    required: ['accountId', 'containerId', 'workspaceId', 'triggerId'],
  },

• src/index.js:405-531 (registration)

  Tool registration in the ListToolsRequest handler, defining name, description, and schema for 'update_trigger'.

  {
    name: 'update_trigger',
    description: '既存のトリガーを更新します。filter、autoEventFilter、waitForTagsなどのすべての設定を更新できます。',
    inputSchema: {
      type: 'object',
      properties: {
        accountId: {
          type: 'string',
          description: 'アカウントID',
        },
        containerId: {
          type: 'string',
          description: 'コンテナID',
        },
        workspaceId: {
          type: 'string',
          description: 'ワークスペースID',
        },
        triggerId: {
          type: 'string',
          description: 'トリガーID',
        },
        name: {
          type: 'string',
          description: 'トリガー名',
        },
        type: {
          type: 'string',
          description: 'トリガータイプ',
        },
        customEventFilter: {
          type: 'array',
          description: 'カスタムイベントフィルタ（CUSTOM_EVENTタイプ用）',
        },
        filter: {
          type: 'array',
          description: 'フィルタ（linkClick、clickなどのタイプ用）',
        },
        autoEventFilter: {
          type: 'array',
          description: '自動イベントフィルタ（linkClickタイプ用）',
        },
        waitForTags: {
          type: 'boolean',
          description: 'タグの待機を有効化（linkClickタイプ用）',
        },
        checkValidation: {
          type: 'boolean',
          description: 'バリデーションチェック（linkClickタイプ用）',
        },
        waitForTagsTimeout: {
          type: 'number',
          description: 'タグ待機タイムアウト（ミリ秒、linkClickタイプ用）',
        },
        // formSubmission用
        formId: {
          type: 'string',
          description: 'フォームID（formSubmissionタイプ用）',
        },
        formClasses: {
          type: 'string',
          description: 'フォームクラス（formSubmissionタイプ用）',
        },
        // scrollDepth用
        verticalThreshold: {
          type: 'number',
          description: '垂直スクロール閾値（パーセント、scrollDepthタイプ用）',
        },
        horizontalThreshold: {
          type: 'number',
          description: '水平スクロール閾値（パーセント、scrollDepthタイプ用）',
        },
        // elementVisibility用
        selector: {
          type: 'string',
          description: 'CSSセレクタ（elementVisibilityタイプ用）',
        },
        visiblePercentageThreshold: {
          type: 'number',
          description: '表示割合閾値（パーセント、elementVisibilityタイプ用）',
        },
        continuousTimeMinMilliseconds: {
          type: 'number',
          description: '連続表示時間（ミリ秒、elementVisibilityタイプ用）',
        },
        // youtubeVideo用
        videoId: {
          type: 'string',
          description: 'YouTube動画ID（youtubeVideoタイプ用）',
        },
        enableTriggerOnVideoStart: {
          type: 'boolean',
          description: '動画開始時に発火（youtubeVideoタイプ用）',
        },
        enableTriggerOnVideoProgress: {
          type: 'boolean',
          description: '動画再生中に発火（youtubeVideoタイプ用）',
        },
        enableTriggerOnVideoComplete: {
          type: 'boolean',
          description: '動画完了時に発火（youtubeVideoタイプ用）',
        },
        enableTriggerOnVideoPause: {
          type: 'boolean',
          description: '動画一時停止時に発火（youtubeVideoタイプ用）',
        },
        enableTriggerOnVideoSeek: {
          type: 'boolean',
          description: '動画シーク時に発火（youtubeVideoタイプ用）',
        },
        // timer用
        interval: {
          type: 'number',
          description: 'インターバル（ミリ秒、timerタイプ用）',
        },
        limit: {
          type: 'number',
          description: '発火回数の上限（timerタイプ用）',
        },
        startTimerOn: {
          type: 'string',
          description: 'タイマー開始タイミング（timerタイプ用、例: "windowLoad", "domReady"）',
        },
      },
      required: ['accountId', 'containerId', 'workspaceId', 'triggerId'],
    },
  },

• src/gtm-client.js:245-252 (helper)

  GTMClient helper method that performs the actual Google Tag Manager API update for a trigger using the googleapis library.

  async updateTrigger(accountId, containerId, workspaceId, triggerId, triggerData) {
    await this.ensureAuth();
    const response = await this.tagmanager.accounts.containers.workspaces.triggers.update({
      path: `accounts/${accountId}/containers/${containerId}/workspaces/${workspaceId}/triggers/${triggerId}`,
      requestBody: triggerData
    });
    return response.data;
  }