Workspaces: sync

يتزامن مساحة عمل مع أحدث إصدار حاوية عن طريق تحديث جميع كيانات مساحة العمل غير المُعدَّلة وعرض التعارضات للكيانات المُعدَّلة. تجربة ذلك الآن

الطلب

طلب HTTP

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

المَعلمات

اسم المعلَمة القيمة الوصف
مَعلمات المسار
path string هو المسار النسبي لواجهة برمجة التطبيقات في 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 التحويل الذي يمثله الكيان.

تجربة

يمكنك استخدام مستكشف واجهات برمجة التطبيقات أدناه لطلب هذه الطريقة على البيانات المباشرة والاطّلاع على الاستجابة.