Workspaces: sync

ซิงค์พื้นที่ทำงานกับคอนเทนเนอร์เวอร์ชันล่าสุดโดยการอัปเดตเอนทิตีพื้นที่ทำงานที่ไม่ได้แก้ไขทั้งหมด และแสดงความขัดแย้งสำหรับเอนทิตีที่แก้ไข ลองเลย

ส่งคำขอ

คำขอ HTTP

POST https://www.googleapis.com/tagmanager/v2/+path:sync

พารามิเตอร์

ชื่อพารามิเตอร์ ค่า คำอธิบาย
พารามิเตอร์เส้นทาง
path string เส้นทางแบบสัมพัทธ์ API ของ GTM Workspace ตัวอย่าง: accounts/{account_id}/containers/{container_id}/workspaces/{workspace_id}

การให้สิทธิ์

คำขอนี้ต้องได้รับสิทธิ์ด้วยขอบเขตต่อไปนี้

ขอบเขต
https://www.googleapis.com/auth/tagmanager.edit.containers

โปรดดูข้อมูลเพิ่มเติมที่หน้าการตรวจสอบสิทธิ์และการให้สิทธิ์

เนื้อหาของคำขอ

โปรดอย่าแสดงเนื้อหาของคำขอด้วยวิธีนี้

คำตอบ

หากสำเร็จ เมธอดนี้จะแสดงเนื้อหาการตอบสนองที่มีโครงสร้างต่อไปนี้

{
  "syncStatus": {
    "mergeConflict": boolean,
    "syncError": boolean
  },
  "mergeConflict": [
    {
      "entityInWorkspace": {
        "tag": accounts.containers.workspaces.tags Resource,
        "trigger": accounts.containers.workspaces.triggers Resource,
        "variable": accounts.containers.workspaces.variables Resource,
        "folder": accounts.containers.workspaces.folders Resource,
        "client": accounts.containers.workspaces.clients Resource,
        "transformation": accounts.containers.workspaces.transformations Resource,
        "changeStatus": string
      },
      "entityInBaseVersion": {
        "tag": accounts.containers.workspaces.tags Resource,
        "trigger": accounts.containers.workspaces.triggers Resource,
        "variable": accounts.containers.workspaces.variables Resource,
        "folder": accounts.containers.workspaces.folders Resource,
        "client": accounts.containers.workspaces.clients Resource,
        "transformation": accounts.containers.workspaces.transformations Resource,
        "changeStatus": string
      }
    }
  ]
}
ชื่อพร็อพเพอร์ตี้ ค่า คำอธิบาย Notes
syncStatus nested object ระบุว่าการซิงค์ทำให้เกิดความขัดแย้งในการผสานหรือเกิดข้อผิดพลาดในการซิงค์หรือไม่
syncStatus.mergeConflict boolean การดำเนินการซิงค์ตรวจพบข้อขัดแย้งในการผสาน
syncStatus.syncError boolean เกิดข้อผิดพลาดระหว่างดำเนินการซิงค์ข้อมูล
mergeConflict[] list การผสานเกิดความขัดแย้งหลังการซิงค์ หากใส่ข้อมูลในช่องนี้ ระบบจะยังถือว่าการซิงค์สำเร็จ แต่คุณจะสร้างเวอร์ชันไม่ได้จนกว่าจะแก้ไขความขัดแย้งทั้งหมด
mergeConflict[].entityInWorkspace nested object เอนทิตีพื้นที่ทำงานที่มีการเปลี่ยนแปลงที่ขัดแย้งกันเมื่อเทียบกับเวอร์ชันพื้นฐาน หากเอนทิตีถูกลบในพื้นที่ทำงาน เอนทิตีจะยังคงปรากฏโดยมีสถานะการเปลี่ยนแปลงเป็นลบแล้ว
mergeConflict[].entityInWorkspace.tag nested object แท็กที่เอนทิตีแสดงแทน
mergeConflict[].entityInWorkspace.trigger nested object ทริกเกอร์ที่เอนทิตีนำเสนอ
mergeConflict[].entityInWorkspace.variable nested object ตัวแปรที่เอนทิตีแสดงแทน
mergeConflict[].entityInWorkspace.folder nested object โฟลเดอร์ที่เอนทิตีแสดงแทน
mergeConflict[].entityInWorkspace.changeStatus string แสดงการเปลี่ยนแปลงเอนทิตีในพื้นที่ทำงาน

ค่าที่ยอมรับมีดังนี้
  • "added"
  • "changeStatusUnspecified"
  • "deleted"
  • "none"
  • "updated"
mergeConflict[].entityInBaseVersion nested object เอนทิตีเวอร์ชันฐาน (ตั้งแต่การดำเนินการซิงค์ล่าสุด) ที่มีการเปลี่ยนแปลงที่ขัดแย้งกันเมื่อเทียบกับพื้นที่ทำงาน ถ้าไม่มีช่องนี้ แสดงว่าเอนทิตีพื้นที่ทำงานจะถูกลบออกจากเวอร์ชันพื้นฐาน
mergeConflict[].entityInBaseVersion.tag nested object แท็กที่เอนทิตีแสดงแทน
mergeConflict[].entityInBaseVersion.trigger nested object ทริกเกอร์ที่เอนทิตีนำเสนอ
mergeConflict[].entityInBaseVersion.variable nested object ตัวแปรที่เอนทิตีแสดงแทน
mergeConflict[].entityInBaseVersion.folder nested object โฟลเดอร์ที่เอนทิตีแสดงแทน
mergeConflict[].entityInBaseVersion.changeStatus string แสดงการเปลี่ยนแปลงเอนทิตีในพื้นที่ทำงาน

ค่าที่ยอมรับมีดังนี้
  • "added"
  • "changeStatusUnspecified"
  • "deleted"
  • "none"
  • "updated"
mergeConflict[].entityInWorkspace.client nested object ลูกค้าที่นิติบุคคลเป็นตัวแทน
mergeConflict[].entityInBaseVersion.client nested object ลูกค้าที่นิติบุคคลเป็นตัวแทน
mergeConflict[].entityInWorkspace.transformation nested object การเปลี่ยนรูปแบบที่เอนทิตีนำเสนอ
mergeConflict[].entityInBaseVersion.transformation nested object การเปลี่ยนรูปแบบที่เอนทิตีนำเสนอ

ลองใช้เลย

ใช้ API Explorer ด้านล่างเพื่อเรียกใช้เมธอดนี้กับข้อมูลแบบเรียลไทม์และดูการตอบสนอง