خدمة "إدارة العلامات من Google"

توفّر خدمة "إدارة العلامات من Google" إمكانية الوصول إلى بيانات واجهة برمجة التطبيقات Tag Manager لمستخدم مفوَّض. تسمح هذه الخدمة لمستخدمي أداة "إدارة العلامات من Google" بإدارة حسابات و حاويات و بيئات و إصدارات و مساحات عمل و مجلدات و متغيّرات و مشغّلات و علامات و أذونات المستخدمين.

مراجع

للحصول على معلومات تفصيلية عن هذه الخدمة، يُرجى الاطّلاع على المستندات المرجعية لTag Manager API V2.

مثل جميع الخدمات المتقدّمة في Apps Script، تستخدِم خدمة "إدارة العلامات من Google" العناصر والطُرق والمَعلمات نفسها المستخدَمة في واجهة برمجة التطبيقات المتاحة للجميع. لمزيد من المعلومات، اطّلِع على كيفية تحديد توقيعات الطرق.

للإبلاغ عن المشاكل والعثور على دعم آخر، يُرجى الاطّلاع على مركز مساعدة أداة "إدارة العلامات من Google".

نموذج التعليمات البرمجية

يوضّح نموذج الرمز البرمجي أدناه كيفية استخدام بعض ميزات خدمة "إدارة العلامات من Google".

تُنشئ نسخة حاوية تتضمّن متغيّرًا وعامل تشغيل وعلامة.

يستخدِم نموذج الرمز البرمجي أدناه الإصدار 2 من Tag Manager API ل إنشاء حاوية أولاً باسم يحمل الطابع الزمني للتاريخ الحالي لزيادة فرص أن تكون فريدة. بعد ذلك، ينشئ العيّنة مساحة عمل بمتغيّر قيمة عشوائي وعامل تشغيل يتم تشغيله لأيّ مشاهدة صفحة. بعد ذلك، يستخدِم العيّنة عامل التفعيل لإنشاء علامة بكسل عشوائية تُشغِّل بكسل إلى //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);
  }
}

تنشر هذه الميزة إصدارًا من الحاوية وتُجري معاينة سريعة لمسودة الحاوية الحالية.

يستخدِم نموذج الرمز البرمجي أدناه الإصدار 2 من Tag Manager API لقبول إصدار حاوية قد تم إنشاؤه في المثال أعلاه، واسترداد معرّفات الحساب والحاوية والإصدار من الإصدار. يستخدم المثال أرقام التعريف هذه لنشر إصدار الحاوية مباشرةً للجميع. أخيرًا، ينشئ العيّنة معاينة سريعة لمساحة عمل جديدة ويُسجّل هذه المحاولة.

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);
  }
}

لإنشاء بيئة مستخدم وإعادة تفويضها

يستخدم نموذج الرمز البرمجي أدناه الإصدار 2 من Tag Manager API لقبول إصدار حاوية واستخراج معرّفات الحساب والحاوية والإصدار. يستخدم النموذج أرقام التعريف هذه لإنشاء بيئة مستخدم تشير إلى إصدار حاوية الإدخال وتسجّل بيئة المستخدم. وينتهي المثال بتسجيل بيئة مستخدم تمت إعادة تفويضها.

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);
  }
}

تسجِّل جميع رسائل البريد الإلكتروني وأذونات الوصول إلى الحاوية ضمن حساب.

يستخدِم نموذج الرمز البرمجي أدناه الإصدار 2 من Tag Manager API للعثور على قائمة بجميع الأذونات ضمن حساب على أداة "إدارة العلامات من Google". بعد ذلك، يسجِّل العيّنة عنوان البريد الإلكتروني للمستخدم ورقم تعريف الحاوية وأنواع أذونات الوصول إلى الحاوية لكل إدخال.

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);
  }
}