Workspaces: sync

با به‌روزرسانی همه موجودیت‌های فضای کاری اصلاح‌نشده و نمایش تداخل‌ها برای موجودیت‌های اصلاح‌شده، یک فضای کاری را با آخرین نسخه ظرف همگام‌سازی می‌کند. الآن امتحانش کن .

درخواست

درخواست HTTP

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

مولفه های

نام پارامتر ارزش شرح
پارامترهای مسیر
path string مسیر نسبی API GTM Workspace. مثال: accounts/{account_id}/containers/{container_id}/workspace/{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
      }
    }
  ]
}
نام ملک ارزش شرح یادداشت
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 تبدیلی که توسط موجودیت نشان داده می شود.

آن را امتحان کنید!

از APIs Explorer زیر برای فراخوانی این روش در داده‌های زنده و دیدن پاسخ استفاده کنید.