Container Versions

เวอร์ชันคอนเทนเนอร์ของคอนเทนเนอร์ เวอร์ชันคอนเทนเนอร์เปรียบได้กับสำเนาที่เปลี่ยนแปลงไม่ได้ (สแนปช็อต) ของการกำหนดค่าของคอนเทนเนอร์ในช่วงเวลาหนึ่งๆ การสร้างเวอร์ชันใหม่โดยใช้เมธอด create จะสร้างเวอร์ชันตามการกำหนดค่าปัจจุบัน (เช่น มาโคร กฎ และแท็กของคอนเทนเนอร์) เมธอด restore จะคืนค่าการกำหนดค่าของคอนเทนเนอร์โดยใช้เวอร์ชันที่ระบุ เมธอด update ช่วยให้อัปเดตช่อง name และ notes ของเวอร์ชันได้ หากต้องการดึงข้อมูลเวอร์ชันที่เผยแพร่ในปัจจุบัน ให้ใช้เมธอด get และระบุ published สำหรับ containerVersionId

ดูรายการเมธอดสำหรับทรัพยากรนี้ได้ที่ส่วนท้ายของหน้านี้

การนำเสนอแหล่งข้อมูล

แสดงเวอร์ชันคอนเทนเนอร์ Google Tag Manager

{
  "accountId": string,
  "containerId": string,
  "containerVersionId": string,
  "name": string,
  "deleted": boolean,
  "notes": string,
  "container": accounts.containers Resource,
  "macro": [
    {
      "accountId": string,
      "containerId": string,
      "macroId": string,
      "name": string,
      "type": string,
      "notes": string,
      "scheduleStartMs": long,
      "scheduleEndMs": long,
      "parameter": [
        {
          "type": string,
          "key": string,
          "value": string,
          "list": [
            (Parameter)
          ],
          "map": [
            (Parameter)
          ]
        }
      ],
      "enablingRuleId": [
        string
      ],
      "disablingRuleId": [
        string
      ],
      "fingerprint": string,
      "parentFolderId": string
    }
  ],
  "rule": [
    {
      "accountId": string,
      "containerId": string,
      "ruleId": string,
      "name": string,
      "notes": string,
      "condition": [
        {
          "type": string,
          "parameter": [
            {
              "type": string,
              "key": string,
              "value": string,
              "list": [
                (Parameter)
              ],
              "map": [
                (Parameter)
              ]
            }
          ]
        }
      ],
      "fingerprint": string
    }
  ],
  "tag": [
    accounts.containers.tags Resource
  ],
  "trigger": [
    accounts.containers.triggers Resource
  ],
  "variable": [
    accounts.containers.variables Resource
  ],
  "folder": [
    accounts.containers.folders Resource
  ],
  "fingerprint": string
}
ชื่อพร็อพเพอร์ตี้ ค่า คำอธิบาย หมายเหตุ
accountId string รหัสบัญชี GTM
container nested object คอนเทนเนอร์ที่ใช้เวอร์ชันนี้มา
containerId string รหัสคอนเทนเนอร์ GTM
containerVersionId string containerVersionId จะระบุเวอร์ชันคอนเทนเนอร์ GTM แบบไม่ซ้ำ
deleted boolean ค่า "จริง" บ่งบอกว่ามีการลบคอนเทนเนอร์เวอร์ชันนี้ออกไปแล้ว
fingerprint string ลายนิ้วมือของเวอร์ชันคอนเทนเนอร์ GTM ที่คำนวณขณะจัดเก็บ ระบบจะคำนวณค่านี้ใหม่เมื่อมีการแก้ไขเวอร์ชันคอนเทนเนอร์
folder[] list โฟลเดอร์ในคอนเทนเนอร์ที่เป็นต้นทางของเวอร์ชันนี้
macro[] list มาโครในคอนเทนเนอร์ที่เป็นต้นทางของเวอร์ชันนี้
macro[].accountId string รหัสบัญชี GTM
macro[].containerId string รหัสคอนเทนเนอร์ GTM
macro[].disablingRuleId[] list สำหรับคอนเทนเนอร์อุปกรณ์เคลื่อนที่เท่านั้น: รายการรหัสกฎสำหรับการปิดใช้มาโครแบบมีเงื่อนไข มาโครจะถูกเปิดใช้งานหากกฎเปิดใช้งานข้อใดข้อหนึ่งเป็นจริงในขณะที่กฎปิดใช้งานทั้งหมดเป็นเท็จ ถือเป็นชุดที่ไม่ได้เรียงลำดับ
macro[].enablingRuleId[] list สำหรับคอนเทนเนอร์บนอุปกรณ์เคลื่อนที่เท่านั้น: รายการรหัสกฎสำหรับเปิดใช้มาโครแบบมีเงื่อนไข มาโครจะถูกเปิดใช้งานหากกฎเปิดใช้งานข้อใดข้อหนึ่งเป็นจริงในขณะที่กฎปิดใช้งานทั้งหมดเป็นเท็จ ถือเป็นชุดที่ไม่ได้เรียงลำดับ
macro[].fingerprint string ลายนิ้วมือของมาโคร GTM ที่คำนวณขณะเก็บข้อมูล ระบบจะคำนวณค่านี้ใหม่เมื่อมีการแก้ไขมาโคร
macro[].macroId string รหัสมาโครจะระบุมาโคร GTM ได้แบบไม่ซ้ำกัน
macro[].name string ชื่อที่แสดงของมาโคร
macro[].notes string หมายเหตุของผู้ใช้เกี่ยวกับวิธีใช้มาโครนี้ในคอนเทนเนอร์
macro[].parameter[] list พารามิเตอร์ของมาโคร
macro[].parameter[].key string คีย์ที่มีชื่อซึ่งระบุพารามิเตอร์ได้โดยไม่ซ้ำกัน ต้องระบุสำหรับพารามิเตอร์ระดับบนสุดและค่าแมป ละเว้นสำหรับค่ารายการ เขียนได้
macro[].parameter[].list[] list พารามิเตอร์ของพารามิเตอร์รายการนี้ (ระบบจะไม่สนใจคีย์) เขียนได้
macro[].parameter[].map[] list พารามิเตอร์ของพารามิเตอร์แมปนี้ (ต้องมีคีย์ คีย์ต้องไม่ซ้ำกัน) เขียนได้
macro[].parameter[].type string ประเภทพารามิเตอร์ ค่าที่ถูกต้องคือ:
  • boolean: ค่าแสดงถึงบูลีนซึ่งแสดงเป็น "จริง" หรือ "เท็จ"
  • integer: ค่านี้จะแสดงค่าจำนวนเต็มที่มีเครื่องหมาย 64 บิตในฐาน 10
  • list: ควรระบุรายการพารามิเตอร์
  • map: ควรระบุการแมปพารามิเตอร์
  • template: ค่านี้จะแสดงข้อความใดก็ได้ ข้อมูลนี้อาจรวมถึงการอ้างอิงตัวแปร (รวมถึงการอ้างอิงตัวแปรที่อาจแสดงประเภทที่ไม่ใช่สตริง)
  • trigger_reference: ค่าแสดงถึงทริกเกอร์ ซึ่งแสดงเป็นรหัสทริกเกอร์


ค่าที่ยอมรับได้ มีดังนี้
  • "boolean"
  • "integer"
  • "list"
  • "map"
  • "template"
  • "triggerReference"
เขียนได้
macro[].parameter[].value string ค่าของพารามิเตอร์ (อาจมีการอ้างอิงตัวแปร เช่น "") ตามความเหมาะสมกับประเภทที่ระบุ เขียนได้
macro[].parentFolderId string รหัสโฟลเดอร์หลัก
macro[].scheduleEndMs long การประทับเวลาสิ้นสุดในหน่วยมิลลิวินาทีเพื่อตั้งเวลามาโคร
macro[].scheduleStartMs long การประทับเวลาเริ่มต้นเป็นมิลลิวินาทีเพื่อกำหนดเวลาให้มาโคร
macro[].type string ประเภทมาโคร GTM
name string ชื่อที่แสดงของเวอร์ชันคอนเทนเนอร์ เขียนได้
notes string หมายเหตุผู้ใช้เกี่ยวกับวิธีใช้คอนเทนเนอร์เวอร์ชันนี้ในคอนเทนเนอร์ เขียนได้
rule[] list กฎในคอนเทนเนอร์ที่เป็นต้นทางของเวอร์ชันนี้
rule[].accountId string รหัสบัญชี GTM
rule[].condition[] list รายการเงื่อนไขที่ประกอบขึ้นเป็นกฎนี้ (โดยนัย AND ระหว่างกฎเหล่านั้น)
rule[].condition[].parameter[] list รายการพารามิเตอร์ที่มีชื่อ (คีย์/ค่า) ขึ้นอยู่กับประเภทของเงื่อนไข หมายเหตุ:
  • สำหรับโอเปอเรเตอร์ไบนารี ให้รวมพารามิเตอร์ชื่อ arg0 และ arg1 เพื่อระบุตัวถูกดำเนินการซ้ายและขวาตามลำดับ
  • ในขณะนี้ ตัวถูกดำเนินการด้านซ้าย (arg0) ต้องอ้างอิงไปยังตัวแปร
  • สำหรับการจับคู่นิพจน์ทั่วไปที่ไม่คำนึงถึงตัวพิมพ์เล็กและตัวพิมพ์ใหญ่ ให้ใส่พารามิเตอร์บูลีนชื่อ ignore_case ซึ่งตั้งค่าเป็น true หากไม่ได้ระบุหรือตั้งเป็นค่าอื่น การจับคู่จะคำนึงถึงตัวพิมพ์เล็กและตัวพิมพ์ใหญ่
  • หากต้องการลบโอเปอเรเตอร์ ให้ใส่พารามิเตอร์บูลีนชื่อ negate พารามิเตอร์บูลีนซึ่งตั้งค่าเป็น true
เขียนได้
rule[].condition[].parameter[].key string คีย์ที่มีชื่อซึ่งระบุพารามิเตอร์ได้โดยไม่ซ้ำกัน ต้องระบุสำหรับพารามิเตอร์ระดับบนสุดและค่าแมป ละเว้นสำหรับค่ารายการ เขียนได้
rule[].condition[].parameter[].list[] list พารามิเตอร์ของพารามิเตอร์รายการนี้ (ระบบจะไม่สนใจคีย์) เขียนได้
rule[].condition[].parameter[].map[] list พารามิเตอร์ของพารามิเตอร์แมปนี้ (ต้องมีคีย์ คีย์ต้องไม่ซ้ำกัน) เขียนได้
rule[].condition[].parameter[].type string ประเภทพารามิเตอร์ ค่าที่ถูกต้องคือ:
  • boolean: ค่าแสดงถึงบูลีนซึ่งแสดงเป็น "จริง" หรือ "เท็จ"
  • integer: ค่านี้จะแสดงค่าจำนวนเต็มที่มีเครื่องหมาย 64 บิตในฐาน 10
  • list: ควรระบุรายการพารามิเตอร์
  • map: ควรระบุการแมปพารามิเตอร์
  • template: ค่านี้จะแสดงข้อความใดก็ได้ ข้อมูลนี้อาจรวมถึงการอ้างอิงตัวแปร (รวมถึงการอ้างอิงตัวแปรที่อาจแสดงประเภทที่ไม่ใช่สตริง)
  • trigger_reference: ค่าแสดงถึงทริกเกอร์ ซึ่งแสดงเป็นรหัสทริกเกอร์


ค่าที่ยอมรับได้ มีดังนี้
  • "boolean"
  • "integer"
  • "list"
  • "map"
  • "template"
  • "triggerReference"
เขียนได้
rule[].condition[].parameter[].value string ค่าของพารามิเตอร์ (อาจมีการอ้างอิงตัวแปร เช่น "") ตามความเหมาะสมกับประเภทที่ระบุ เขียนได้
rule[].condition[].type string ประเภทของโอเปอเรเตอร์สำหรับเงื่อนไขนี้

ค่าที่ยอมรับได้ มีดังนี้
  • "contains"
  • "cssSelector"
  • "endsWith"
  • "equals"
  • "greater"
  • "greaterOrEquals"
  • "less"
  • "lessOrEquals"
  • "matchRegex"
  • "startsWith"
  • "urlMatches"
เขียนได้
rule[].containerId string รหัสคอนเทนเนอร์ GTM
rule[].fingerprint string ลายนิ้วมือของกฎ GTM ที่คำนวณขณะเก็บข้อมูล ระบบจะคำนวณค่านี้ใหม่เมื่อมีการแก้ไขกฎ
rule[].name string ชื่อที่แสดงของกฎ
rule[].notes string หมายเหตุของผู้ใช้เกี่ยวกับวิธีใช้กฎนี้ในคอนเทนเนอร์
rule[].ruleId string รหัสกฎจะระบุกฎ GTM โดยไม่ซ้ำกัน
tag[] list แท็กในคอนเทนเนอร์ที่เป็นต้นทางของเวอร์ชันนี้
trigger[] list ทริกเกอร์ในคอนเทนเนอร์ที่เป็นต้นทางของเวอร์ชันนี้
variable[] list ตัวแปรในคอนเทนเนอร์ที่เป็นต้นทางของเวอร์ชันนี้

เมธอด

สร้าง
สร้างเวอร์ชันคอนเทนเนอร์
ลบ
ลบเวอร์ชันคอนเทนเนอร์
รับ
ดาวน์โหลดเวอร์ชันคอนเทนเนอร์
list
แสดงรายการคอนเทนเนอร์ GTM ทุกเวอร์ชัน
เผยแพร่
นำเวอร์ชันคอนเทนเนอร์ไปใช้จริง
กู้คืน
คืนค่าเวอร์ชันคอนเทนเนอร์ การดำเนินการนี้จะเขียนทับข้อมูลปัจจุบันของคอนเทนเนอร์ (รวมถึงตัวแปร ทริกเกอร์ และแท็ก) การดำเนินการ จะไม่มีผลใดๆ ต่อเวอร์ชันที่กําลังให้บริการ (เช่น เวอร์ชันที่เผยแพร่)
ยกเลิกการลบ
ยกเลิกการลบเวอร์ชันคอนเทนเนอร์
อัปเดต
อัปเดตเวอร์ชันคอนเทนเนอร์