Workspaces: sync

Đồng bộ hoá không gian làm việc với phiên bản vùng chứa mới nhất bằng cách cập nhật tất cả các thực thể không gian làm việc chưa sửa đổi và hiển thị xung đột cho các thực thể đã sửa đổi. Thử ngay.

Yêu cầu

Yêu cầu HTTP

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

Các tham số

Tên thông số Giá trị Nội dung mô tả
Tham số đường dẫn
path string Đường dẫn tương đối về API của GTM Workspace. Ví dụ: accounts/{account_id}/containers/{container_id}/workspaces/{workspace_id}

Ủy quyền

Yêu cầu này cần được uỷ quyền với phạm vi sau:

Phạm vi
https://www.googleapis.com/auth/tagmanager.edit.containers

Để biết thêm thông tin, hãy xem trang xác thực và uỷ quyền.

Nội dung yêu cầu

Đừng cung cấp nội dung yêu cầu bằng phương thức này.

Phản hồi

Nếu thành công, phương thức này sẽ trả về một nội dung phản hồi có cấu trúc như sau:

{
  "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
      }
    }
  ]
}
Tên tài sản Giá trị Nội dung mô tả Ghi chú
syncStatus nested object Cho biết liệu quá trình đồng bộ hoá có gây ra xung đột hợp nhất hoặc lỗi đồng bộ hoá hay không.
syncStatus.mergeConflict boolean Thao tác Synchornization đã phát hiện một xung đột hợp nhất.
syncStatus.syncError boolean Đã xảy ra lỗi trong quá trình đồng bộ hoá.
mergeConflict[] list Xung đột hợp nhất sau khi đồng bộ hoá. Nếu trường này không trống, thì quá trình đồng bộ hoá vẫn được coi là thành công. Tuy nhiên, bạn không thể tạo một phiên bản cho đến khi giải quyết xong tất cả xung đột.
mergeConflict[].entityInWorkspace nested object Thực thể Workspace có các thay đổi gây mâu thuẫn so với phiên bản cơ sở. Nếu một thực thể bị xoá trong không gian làm việc, thực thể đó sẽ vẫn xuất hiện với trạng thái thay đổi đã bị xoá.
mergeConflict[].entityInWorkspace.tag nested object Thẻ do thực thể đại diện.
mergeConflict[].entityInWorkspace.trigger nested object Điều kiện kích hoạt do thực thể đại diện.
mergeConflict[].entityInWorkspace.variable nested object Biến do thực thể biểu thị.
mergeConflict[].entityInWorkspace.folder nested object Thư mục do thực thể đại diện.
mergeConflict[].entityInWorkspace.changeStatus string Thể hiện cách thực thể đã được thay đổi trong không gian làm việc.

Các giá trị có thể chấp nhận là:
  • "added"
  • "changeStatusUnspecified"
  • "deleted"
  • "none"
  • "updated"
mergeConflict[].entityInBaseVersion nested object Thực thể phiên bản cơ sở (kể từ lần đồng bộ hoá gần đây nhất) có các thay đổi gây mâu thuẫn so với không gian làm việc. Nếu trường này bị thiếu thì tức là thực thể không gian làm việc bị xoá khỏi phiên bản cơ sở.
mergeConflict[].entityInBaseVersion.tag nested object Thẻ do thực thể đại diện.
mergeConflict[].entityInBaseVersion.trigger nested object Điều kiện kích hoạt do thực thể đại diện.
mergeConflict[].entityInBaseVersion.variable nested object Biến do thực thể biểu thị.
mergeConflict[].entityInBaseVersion.folder nested object Thư mục do thực thể đại diện.
mergeConflict[].entityInBaseVersion.changeStatus string Thể hiện cách thực thể đã được thay đổi trong không gian làm việc.

Các giá trị có thể chấp nhận là:
  • "added"
  • "changeStatusUnspecified"
  • "deleted"
  • "none"
  • "updated"
mergeConflict[].entityInWorkspace.client nested object Khách hàng do thực thể đại diện.
mergeConflict[].entityInBaseVersion.client nested object Khách hàng do thực thể đại diện.
mergeConflict[].entityInWorkspace.transformation nested object Phép biến đổi do thực thể biểu thị.
mergeConflict[].entityInBaseVersion.transformation nested object Phép biến đổi do thực thể biểu thị.

Hãy dùng thử!

Hãy sử dụng APIs Explorer bên dưới để gọi phương thức này trên dữ liệu trực tiếp và xem phản hồi.