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
}

ชื่อพร็อพเพอร์ตี้	ค่า	คำอธิบาย	Notes
accountId	string	รหัสบัญชี GTM
container	nested object	คอนเทนเนอร์ที่นําเวอร์ชันนี้มา
containerId	string	รหัสคอนเทนเนอร์ GTM
containerVersionId	string	containerVersionId ระบุเวอร์ชันคอนเทนเนอร์ GTM ที่ไม่ซ้ำกัน
deleted	boolean	ค่า true บ่งบอกว่าคอนเทนเนอร์เวอร์ชันนี้ถูกลบไปแล้ว
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: ค่านี้แทนค่าบูลีน ซึ่งแสดงเป็น "true" หรือ "false" integer: ค่านี้แสดงค่าจำนวนเต็มแบบมีเครื่องหมาย 64 บิตในฐาน 10 list: ควรระบุรายการพารามิเตอร์ map: ควรระบุแมปของพารามิเตอร์ template: ค่าแสดงถึงข้อความทุกอย่าง ซึ่งอาจรวมถึงการอ้างอิงตัวแปร (แม้แต่การอ้างอิงตัวแปรที่อาจแสดงประเภทที่ไม่ใช่สตริง) trigger_reference: ค่านี้แทนทริกเกอร์ ซึ่งแสดงเป็นรหัสทริกเกอร์ ค่าที่ยอมรับมีดังนี้ "boolean" "integer" "list" "map" "template" "triggerReference"	เขียนได้
macro[].parameter[].value	string	ค่าของพารามิเตอร์ (อาจมีการอ้างอิงตัวแปร เช่น "") ตามความเหมาะสมกับประเภทที่ระบุ	เขียนได้
macro[].parentFolderId	string	ID โฟลเดอร์หลัก
macro[].scheduleEndMs	long	การประทับเวลาสิ้นสุดเป็นมิลลิวินาทีเพื่อกำหนดเวลาให้มาโคร
macro[].scheduleStartMs	long	การประทับเวลาเริ่มต้นเป็นมิลลิวินาทีเพื่อกำหนดเวลาให้มาโคร
macro[].type	string	ประเภทมาโคร GTM
name	string	ชื่อที่แสดงของเวอร์ชันคอนเทนเนอร์	เขียนได้
notes	string	ผู้ใช้ระบุวิธีใช้คอนเทนเนอร์เวอร์ชันนี้ในคอนเทนเนอร์	เขียนได้
rule[]	list	กฎในคอนเทนเนอร์ที่นําเวอร์ชันนี้มาใช้
rule[].accountId	string	รหัสบัญชี GTM
rule[].condition[]	list	รายการเงื่อนไขที่เป็นส่วนประกอบของกฎนี้ (โดยนัย และ ระหว่างเงื่อนไข)
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: ค่านี้แทนค่าบูลีน ซึ่งแสดงเป็น "true" หรือ "false" 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

publish

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

กู้คืน

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

undelete

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

อัปเดต

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