タグ マネージャーのサービス

Google タグ マネージャー サービスを利用すると、認証済みユーザーは Tag Manager API のデータにアクセスできます。このサービス タグ マネージャーのユーザーは、タグ マネージャーを管理できます。 アカウント コンテナ 環境、 バージョン、 ワークスペース、 フォルダ variables トリガー タグ ユーザー権限。

リファレンス

このサービスの詳細については、サービス リファレンス ドキュメントの Tag Manager API V2。

Apps Script のすべての高度なサービスと同様に、タグ マネージャー サービスでは、公開 API と同じオブジェクト、メソッド、パラメータを使用します。詳細については、メソッド シグネチャの決定方法をご覧ください。

問題を報告したり、他のサポートを探したりするには、 Google タグ マネージャー ヘルプセンターをご覧ください。

サンプルコード

以下のサンプルコードは、タグ マネージャー サービスの一部の機能の使用方法を示しています。

変数、トリガー、タグを含むコンテナのバージョンを作成する

以下のサンプルコードでは、Tag Manager API V2 を使用して以下を行います。 まず、現在の日付でタイムスタンプが付けられた名前でコンテナを作成します。 一意になる可能性が高まります続いて、ランダム値の変数と、すべてのページビューを対象に配信されるトリガーを含むワークスペースを作成しています。次に サンプルでは、トリガーを使用して、ピクセルを配信する任意のピクセルタグを作成します。 //example.com に追加して、URL の末尾にキャッシュの無効化を追加します。最後に、 サンプルは、上記のエンティティを含むコンテナ バージョンを作成し、そのバージョンと 後で使用するために返されます。

advanced/tagManager.gs
/**
 * Creates a container version for a particular account
 * with the input accountPath.
 * @param {string} accountPath The account path.
 * @return {string} The tag manager container version.
 */
function createContainerVersion(accountPath) {
  const date = new Date();
  // Creates a container in the account, using the current timestamp to make
  // sure the container is unique.
  try {
    const container = TagManager.Accounts.Containers.create(
        {
          'name': 'appscript tagmanager container ' + date.getTime(),
          'usageContext': ['WEB']
        },
        accountPath);
    const containerPath = container.path;
    // Creates a workspace in the container to track entity changes.
    const workspace = TagManager.Accounts.Containers.Workspaces.create(
        {'name': 'appscript workspace', 'description': 'appscript workspace'},
        containerPath);
    const workspacePath = workspace.path;
    // Creates a random value variable.
    const variable = TagManager.Accounts.Containers.Workspaces.Variables.create(
        {'name': 'apps script variable', 'type': 'r'},
        workspacePath);
    // Creates a trigger that fires on any page view.
    const trigger = TagManager.Accounts.Containers.Workspaces.Triggers.create(
        {'name': 'apps script trigger', 'type': 'PAGEVIEW'},
        workspacePath);
    // Creates a arbitary pixel that fires the tag on all page views.
    const tag = TagManager.Accounts.Containers.Workspaces.Tags.create(
        {
          'name': 'apps script tag',
          'type': 'img',
          'liveOnly': false,
          'parameter': [
            {'type': 'boolean', 'key': 'useCacheBuster', 'value': 'true'}, {
              'type': 'template',
              'key': 'cacheBusterQueryParam',
              'value': 'gtmcb'
            },
            {'type': 'template', 'key': 'url', 'value': '//example.com'}
          ],
          'firingTriggerId': [trigger.triggerId]
        },
        workspacePath);
    // Creates a container version with the variabe, trigger, and tag.
    const version = TagManager.Accounts.Containers.Workspaces
        .create_version(
            {'name': 'apps script version'}, workspacePath)
        .containerVersion;
    console.log(version);
    return version;
  } catch (e) {
    // TODO (Developer) - Handle exception
    console.log('Failed with error: %s', e.error);
  }
}

コンテナのバージョンを公開し、現在のドラフト コンテナのクイック プレビューを確認する

以下のサンプルコードでは、Tag Manager API V2 を使用しています。 上記の例で作成したコンテナ バージョンを受け入れます。 アカウント、コンテナ、バージョン ID をバージョンから取得します。このサンプルでは、これらの ID を使用してコンテナのバージョンを公開しています。最後に、サンプルで新しいワークスペースのクイック プレビューが作成され、 プレビューします。

advanced/tagManager.gs
/**
 * Retrieves the container path from a container version path.
 * @param  {string} versionPath The version path.
 * @return {string}             The container path.
 */
function grabContainerPath(versionPath) {
  const pathParts = versionPath.split('/');
  return pathParts.slice(0, 4).join('/');
}

/**
 * Publishes a container version publically to the world and creates a quick
 * preview of the current container draft.
 * @param {object} version The container version.
 */
function publishVersionAndQuickPreviewDraft(version) {
  try {
    const containerPath = grabContainerPath(version.path);
    // Publish the input container version.
    TagManager.Accounts.Containers.Versions.publish(version.path);
    const workspace = TagManager.Accounts.Containers.Workspaces.create(
        {'name': 'appscript workspace', 'description': 'appscript workspace'},
        containerPath);
    const workspaceId = workspace.path;
    // Quick previews the current container draft.
    const quickPreview = TagManager.Accounts.Containers.Workspaces
        .quick_preview(workspace.path);
    console.log(quickPreview);
  } catch (e) {
    // TODO (Developer) - Handle exceptions
    console.log('Failed with error: $s', e.error);
  }
}

ユーザー環境を作成して再認証する

以下のサンプルコードでは、Tag Manager API V2 を使用しています。 コンテナのバージョンを受け入れて、アカウント、コンテナ、 あります。このサンプルでは、これらの ID を使用して、入力コンテナのバージョンを参照するユーザー環境を作成し、それを記録しています。最後に、再認証されたユーザー環境を記録します。

advanced/tagManager.gs
/**
 * Retrieves the container path from a container version path.
 * @param  {string} versionPath The version path.
 * @return {string}             The container path.
 */
function grabContainerPath(versionPath) {
  const pathParts = versionPath.split('/');
  return pathParts.slice(0, 4).join('/');
}

/**
 * Creates and reauthorizes a user environment in a container that points
 * to a container version passed in as an argument.
 * @param {object} version The container version object.
 */
function createAndReauthorizeUserEnvironment(version) {
  try {
    // Creates a container version.
    const containerPath = grabContainerPath(version.path);
    // Creates a user environment that points to a container version.
    const environment = TagManager.Accounts.Containers.Environments.create(
        {
          'name': 'test_environment',
          'type': 'user',
          'containerVersionId': version.containerVersionId
        },
        containerPath);
    console.log('Original user environment: ' + environment);
    // Reauthorizes the user environment that points to a container version.
    TagManager.Accounts.Containers.Environments.reauthorize(
        {}, environment.path);
    console.log('Reauthorized user environment: ' + environment);
  } catch (e) {
    // TODO (Developer) - Handle exceptions
    console.log('Failed with error: $s', e.error);
  }
}

アカウント内のすべてのメールとコンテナのアクセス権を記録する

以下のサンプルコードでは、Tag Manager API V2 を使用しています。 タグ マネージャー アカウントに関するすべての権限のリストを確認できます。その後、ユーザーのメールアドレス、コンテナ ID、各エントリのコンテナのアクセス権の種類を記録します。

advanced/tagManager.gs
/**
 * Logs all emails and container access permission within an account.
 * @param {string} accountPath The account path.
 */
function logAllAccountUserPermissionsWithContainerAccess(accountPath) {
  try {
    const userPermissions =
      TagManager.Accounts.User_permissions.list(accountPath).userPermission;
    for (let i = 0; i < userPermissions.length; i++) {
      const userPermission = userPermissions[i];
      if ('emailAddress' in userPermission) {
        const containerAccesses = userPermission.containerAccess;
        for (let j = 0; j < containerAccesses.length; j++) {
          const containerAccess = containerAccesses[j];
          console.log(
              'emailAddress:' + userPermission.emailAddress +
            ' containerId:' + containerAccess.containerId +
            ' containerAccess:' + containerAccess.permission);
        }
      }
    }
  } catch (e) {
    // TODO (Developer) - Handle exceptions
    console.log('Failed with error: $s', e.error);
  }
}