ট্যাগ ম্যানেজার পরিষেবা

ম্যানেজার এপিআই ডেটা, যার মধ্যে অ্যাকাউন্ট, কন্টেইনার এবং ব্যবহারকারীর অনুমতি অন্তর্ভুক্ত।

গুগল ট্যাগ ম্যানেজার পরিষেবা একজন অনুমোদিত ব্যবহারকারীকে ট্যাগ ম্যানেজার এপিআই ডেটাতে অ্যাক্সেস প্রদান করে। এই পরিষেবা ট্যাগ ম্যানেজার ব্যবহারকারীদের ট্যাগ ম্যানেজার অ্যাকাউন্ট , কন্টেইনার , এনভায়রনমেন্ট , ভার্সন , ওয়ার্কস্পেস , ফোল্ডার , ভেরিয়েবল , ট্রিগার , ট্যাগ এবং ব্যবহারকারীর অনুমতি পরিচালনা করতে দেয়।

এটি একটি উন্নত পরিষেবা যা ব্যবহারের আগে সক্রিয় করতে হবে।

রেফারেন্স

এই পরিষেবা সম্পর্কে বিস্তারিত তথ্যের জন্য, ট্যাগ ম্যানেজার এপিআই ভি২ (Tag Manager API V2)- এর রেফারেন্স ডকুমেন্টেশন দেখুন।

Google Apps Script-এর অন্যান্য সকল অ্যাডভান্সড সার্ভিসের মতো, ট্যাগ ম্যানেজার সার্ভিসটিও পাবলিক এপিআই-এর মতোই একই অবজেক্ট, মেথড এবং প্যারামিটার ব্যবহার করে। আরও তথ্যের জন্য, ‘মেথড সিগনেচার কীভাবে নির্ধারিত হয় ’ দেখুন।

সমস্যা জানাতে এবং অন্যান্য সহায়তা পেতে, গুগল ট্যাগ ম্যানেজার হেল্প সেন্টার দেখুন।

নমুনা কোড

নিম্নলিখিত নমুনা কোডটিতে ট্যাগ ম্যানেজার সার্ভিসের কয়েকটি বৈশিষ্ট্য কীভাবে ব্যবহার করতে হয় তা দেখানো হয়েছে।

ভেরিয়েবল, ট্রিগার এবং ট্যাগ সহ একটি কন্টেইনার সংস্করণ তৈরি করে।

নিম্নলিখিত নমুনা কোডটি ট্যাগ ম্যানেজার এপিআই ভি২ (Tag Manager API V2) ব্যবহার করে প্রথমে একটি কন্টেইনার তৈরি করে, যার নামে বর্তমান তারিখের টাইমস্ট্যাম্প যুক্ত করা থাকে, যাতে এটির অনন্য হওয়ার সম্ভাবনা বাড়ে। এরপর নমুনাটি একটি র‍্যান্ডম ভ্যালু ভ্যারিয়েবলসহ একটি ওয়ার্কস্পেস এবং যেকোনো পেজ ভিউয়ের জন্য চালু হওয়া একটি ট্রিগার তৈরি করে। পরবর্তীকালে, নমুনাটি ট্রিগারটি ব্যবহার করে একটি নির্বিচার পিক্সেল ট্যাগ তৈরি করে, যা //example.com এ একটি পিক্সেল ফায়ার করে এবং ইউআরএল-এর শেষে একটি ক্যাশ বাস্টার যুক্ত করে। সবশেষে, নমুনাটি এই এনটিটিগুলো দিয়ে একটি কন্টেইনার ভার্সন তৈরি করে, ভার্সনটি লগ করে এবং পরবর্তী ব্যবহারের জন্য তা রিটার্ন করে।

অ্যাডভান্সড/ট্যাগম্যানেজার.জিএস
/**
 * 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) ব্যবহার করে পূর্ববর্তী উদাহরণে তৈরি করা একটি কন্টেইনার সংস্করণ গ্রহণ করে এবং সেই সংস্করণ থেকে অ্যাকাউন্ট, কন্টেইনার ও সংস্করণ আইডিগুলো পুনরুদ্ধার করে। নমুনাটি এই আইডিগুলো ব্যবহার করে একটি কন্টেইনার সংস্করণ বিশ্বব্যাপী লাইভ প্রকাশ করে। সবশেষে, নমুনাটি একটি নতুন ওয়ার্কস্পেসের দ্রুত প্রিভিউ তৈরি করে এবং সেই প্রিভিউটি লগ করে।

অ্যাডভান্সড/ট্যাগম্যানেজার.জিএস
/**
 * 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 pathParts = version.path.split("/");
    const containerPath = pathParts.slice(0, 4).join("/");
    // 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) ব্যবহার করে একটি কন্টেইনার সংস্করণ গ্রহণ করে এবং অ্যাকাউন্ট, কন্টেইনার ও সংস্করণ আইডিগুলো বের করে। নমুনাটি এই আইডিগুলো ব্যবহার করে একটি ব্যবহারকারী পরিবেশ (user environment) তৈরি করে যা ইনপুট করা কন্টেইনার সংস্করণটিকে নির্দেশ করে এবং সেই ব্যবহারকারী পরিবেশটি লগ করে। নমুনাটি একটি পুনঃঅনুমোদিত ব্যবহারকারী পরিবেশ লগ করার মাধ্যমে শেষ হয়।

অ্যাডভান্সড/ট্যাগম্যানেজার.জিএস
/**
 * 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 pathParts = version.path.split("/");
    const containerPath = pathParts.slice(0, 4).join("/");
    // 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) ব্যবহার করে। এরপর নমুনাটি প্রতিটি এন্ট্রির জন্য ব্যবহারকারীর ইমেল ঠিকানা, কন্টেইনার আইডি এবং কন্টেইনার অ্যাক্সেস অনুমতির ধরনগুলো লগ করে রাখে।

অ্যাডভান্সড/ট্যাগম্যানেজার.জিএস
/**
 * 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);
  }
}