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 ทุกเวอร์ชัน

เผยแพร่

นำเวอร์ชันคอนเทนเนอร์ไปใช้จริง

กู้คืน

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

ยกเลิกการลบ

ยกเลิกการลบเวอร์ชันคอนเทนเนอร์

อัปเดต

อัปเดตเวอร์ชันคอนเทนเนอร์