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,
        "zone": accounts.containers.workspaces.zones Resource,
        "customTemplate": accounts.containers.workspaces.templates Resource,
        "builtInVariable": {
          "path": string,
          "accountId": string,
          "containerId": string,
          "workspaceId": string,
          "type": string,
          "name": string
        },
        "gtagConfig": accounts.containers.workspaces.gtag_config 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,
        "zone": accounts.containers.workspaces.zones Resource,
        "customTemplate": accounts.containers.workspaces.templates Resource,
        "builtInVariable": {
          "path": string,
          "accountId": string,
          "containerId": string,
          "workspaceId": string,
          "type": string,
          "name": string
        },
        "gtagConfig": accounts.containers.workspaces.gtag_config Resource,
        "changeStatus": string
      }
    }
  ]
}
اسم الموقع القيمة الوصف Notes
syncStatus nested object يشير إلى ما إذا كانت المزامنة تسببت في حدوث تعارض في الدمج أو خطأ في المزامنة.
syncStatus.mergeConflict boolean اكتشفت عملية المزامنة وجود تعارض في الدمج.
syncStatus.syncError boolean حدث خطأ أثناء عملية المزامنة.
mergeConflict[] list يتعارض الدمج بعد المزامنة. وإذا لم يكن هذا الحقل فارغًا، سيستمر التعامل مع المزامنة على أنّها ناجحة. ولكن لا يمكن إنشاء نسخة إلا بعد حل جميع التعارضات.
mergeConflict[].entityInWorkspace nested object كيان Workspace الذي يتضمّن تغييرات متعارضة مقارنةً بالإصدار الأساسي. إذا تم حذف عنصر في مساحة عمل، سيظل يظهر بحالة تغيير محذوفة.
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 التحويل الذي يمثله الكيان.
mergeConflict[].entityInWorkspace.zone nested object المنطقة التي يمثلها الكيان.
mergeConflict[].entityInWorkspace.customTemplate nested object النموذج المخصّص الذي يتم تمثيله من قِبل العنصر.
mergeConflict[].entityInWorkspace.builtInVariable nested object المتغير المضمن الذي يمثله الكيان.
mergeConflict[].entityInWorkspace.builtInVariable.path string المسار النسبي لواجهة برمجة التطبيقات في GTM BuiltInVariable.
mergeConflict[].entityInWorkspace.builtInVariable.accountId string رقم تعريف حساب "إدارة العلامات من Google"
mergeConflict[].entityInWorkspace.builtInVariable.containerId string رقم تعريف حاوية Google Tag Manager
mergeConflict[].entityInWorkspace.builtInVariable.workspaceId string رقم تعريف Workspace في "إدارة العلامات من Google"
mergeConflict[].entityInWorkspace.builtInVariable.type string تمثّل هذه السمة نوع المتغيّر المضمَّن.

في ما يلي القيم المقبولة:
  • "advertiserId"
  • "advertisingTrackingEnabled"
  • "ampBrowserLanguage"
  • "ampCanonicalHost"
  • "ampCanonicalPath"
  • "ampCanonicalUrl"
  • "ampClientId"
  • "ampClientMaxScrollX"
  • "ampClientMaxScrollY"
  • "ampClientScreenHeight"
  • "ampClientScreenWidth"
  • "ampClientScrollX"
  • "ampClientScrollY"
  • "ampClientTimestamp"
  • "ampClientTimezone"
  • "ampGtmEvent"
  • "ampPageDownloadTime"
  • "ampPageLoadTime"
  • "ampPageViewId"
  • "ampReferrer"
  • "ampTitle"
  • "ampTotalEngagedTime"
  • "appId"
  • "appName"
  • "appVersionCode"
  • "appVersionName"
  • "builtInVariableTypeUnspecified"
  • "clickClasses"
  • "clickElement"
  • "clickId"
  • "clickTarget"
  • "clickText"
  • "clickUrl"
  • "clientName"
  • "containerId"
  • "containerVersion"
  • "debugMode"
  • "deviceName"
  • "elementVisibilityFirstTime"
  • "elementVisibilityRatio"
  • "elementVisibilityRecentTime"
  • "elementVisibilityTime"
  • "environmentName"
  • "errorLine"
  • "errorMessage"
  • "errorUrl"
  • "event"
  • "eventName"
  • "firebaseEventParameterCampaign"
  • "firebaseEventParameterCampaignAclid"
  • "firebaseEventParameterCampaignAnid"
  • "firebaseEventParameterCampaignClickTimestamp"
  • "firebaseEventParameterCampaignContent"
  • "firebaseEventParameterCampaignCp1"
  • "firebaseEventParameterCampaignGclid"
  • "firebaseEventParameterCampaignSource"
  • "firebaseEventParameterCampaignTerm"
  • "firebaseEventParameterCurrency"
  • "firebaseEventParameterDynamicLinkAcceptTime"
  • "firebaseEventParameterDynamicLinkLinkid"
  • "firebaseEventParameterNotificationMessageDeviceTime"
  • "firebaseEventParameterNotificationMessageId"
  • "firebaseEventParameterNotificationMessageName"
  • "firebaseEventParameterNotificationMessageTime"
  • "firebaseEventParameterNotificationTopic"
  • "firebaseEventParameterPreviousAppVersion"
  • "firebaseEventParameterPreviousOsVersion"
  • "firebaseEventParameterPrice"
  • "firebaseEventParameterProductId"
  • "firebaseEventParameterQuantity"
  • "firebaseEventParameterValue"
  • "firstPartyServingUrl"
  • "formClasses"
  • "formElement"
  • "formId"
  • "formTarget"
  • "formText"
  • "formUrl"
  • "historySource"
  • "htmlId"
  • "language"
  • "newHistoryFragment"
  • "newHistoryState"
  • "newHistoryUrl"
  • "oldHistoryFragment"
  • "oldHistoryState"
  • "oldHistoryUrl"
  • "osVersion"
  • "pageHostname"
  • "pagePath"
  • "pageUrl"
  • "platform"
  • "queryString"
  • "randomNumber"
  • "referrer"
  • "requestMethod"
  • "requestPath"
  • "resolution"
  • "scrollDepthDirection"
  • "scrollDepthThreshold"
  • "scrollDepthUnits"
  • "sdkVersion"
  • "serverPageLocationHostname"
  • "serverPageLocationPath"
  • "serverPageLocationUrl"
  • "videoCurrentTime"
  • "videoDuration"
  • "videoPercent"
  • "videoProvider"
  • "videoStatus"
  • "videoTitle"
  • "videoUrl"
  • "videoVisible"
  • "visitorRegion"
mergeConflict[].entityInWorkspace.builtInVariable.name string يشير ذلك المصطلح إلى اسم المتغيّر المضمَّن الذي سيتم استخدامه للإشارة إلى المتغيّر المضمَّن.
mergeConflict[].entityInWorkspace.gtagConfig nested object إعداد gtag الذي يمثله الكيان.
mergeConflict[].entityInBaseVersion.zone nested object المنطقة التي يمثلها الكيان.
mergeConflict[].entityInBaseVersion.customTemplate nested object النموذج المخصّص الذي يتم تمثيله من قِبل العنصر.
mergeConflict[].entityInBaseVersion.builtInVariable nested object المتغير المضمن الذي يمثله الكيان.
mergeConflict[].entityInBaseVersion.builtInVariable.path string المسار النسبي لواجهة برمجة التطبيقات في GTM BuiltInVariable.
mergeConflict[].entityInBaseVersion.builtInVariable.accountId string رقم تعريف حساب "إدارة العلامات من Google"
mergeConflict[].entityInBaseVersion.builtInVariable.containerId string رقم تعريف حاوية Google Tag Manager
mergeConflict[].entityInBaseVersion.builtInVariable.workspaceId string رقم تعريف Workspace في "إدارة العلامات من Google"
mergeConflict[].entityInBaseVersion.builtInVariable.type string تمثّل هذه السمة نوع المتغيّر المضمَّن.

في ما يلي القيم المقبولة:
  • "advertiserId"
  • "advertisingTrackingEnabled"
  • "ampBrowserLanguage"
  • "ampCanonicalHost"
  • "ampCanonicalPath"
  • "ampCanonicalUrl"
  • "ampClientId"
  • "ampClientMaxScrollX"
  • "ampClientMaxScrollY"
  • "ampClientScreenHeight"
  • "ampClientScreenWidth"
  • "ampClientScrollX"
  • "ampClientScrollY"
  • "ampClientTimestamp"
  • "ampClientTimezone"
  • "ampGtmEvent"
  • "ampPageDownloadTime"
  • "ampPageLoadTime"
  • "ampPageViewId"
  • "ampReferrer"
  • "ampTitle"
  • "ampTotalEngagedTime"
  • "appId"
  • "appName"
  • "appVersionCode"
  • "appVersionName"
  • "builtInVariableTypeUnspecified"
  • "clickClasses"
  • "clickElement"
  • "clickId"
  • "clickTarget"
  • "clickText"
  • "clickUrl"
  • "clientName"
  • "containerId"
  • "containerVersion"
  • "debugMode"
  • "deviceName"
  • "elementVisibilityFirstTime"
  • "elementVisibilityRatio"
  • "elementVisibilityRecentTime"
  • "elementVisibilityTime"
  • "environmentName"
  • "errorLine"
  • "errorMessage"
  • "errorUrl"
  • "event"
  • "eventName"
  • "firebaseEventParameterCampaign"
  • "firebaseEventParameterCampaignAclid"
  • "firebaseEventParameterCampaignAnid"
  • "firebaseEventParameterCampaignClickTimestamp"
  • "firebaseEventParameterCampaignContent"
  • "firebaseEventParameterCampaignCp1"
  • "firebaseEventParameterCampaignGclid"
  • "firebaseEventParameterCampaignSource"
  • "firebaseEventParameterCampaignTerm"
  • "firebaseEventParameterCurrency"
  • "firebaseEventParameterDynamicLinkAcceptTime"
  • "firebaseEventParameterDynamicLinkLinkid"
  • "firebaseEventParameterNotificationMessageDeviceTime"
  • "firebaseEventParameterNotificationMessageId"
  • "firebaseEventParameterNotificationMessageName"
  • "firebaseEventParameterNotificationMessageTime"
  • "firebaseEventParameterNotificationTopic"
  • "firebaseEventParameterPreviousAppVersion"
  • "firebaseEventParameterPreviousOsVersion"
  • "firebaseEventParameterPrice"
  • "firebaseEventParameterProductId"
  • "firebaseEventParameterQuantity"
  • "firebaseEventParameterValue"
  • "firstPartyServingUrl"
  • "formClasses"
  • "formElement"
  • "formId"
  • "formTarget"
  • "formText"
  • "formUrl"
  • "historySource"
  • "htmlId"
  • "language"
  • "newHistoryFragment"
  • "newHistoryState"
  • "newHistoryUrl"
  • "oldHistoryFragment"
  • "oldHistoryState"
  • "oldHistoryUrl"
  • "osVersion"
  • "pageHostname"
  • "pagePath"
  • "pageUrl"
  • "platform"
  • "queryString"
  • "randomNumber"
  • "referrer"
  • "requestMethod"
  • "requestPath"
  • "resolution"
  • "scrollDepthDirection"
  • "scrollDepthThreshold"
  • "scrollDepthUnits"
  • "sdkVersion"
  • "serverPageLocationHostname"
  • "serverPageLocationPath"
  • "serverPageLocationUrl"
  • "videoCurrentTime"
  • "videoDuration"
  • "videoPercent"
  • "videoProvider"
  • "videoStatus"
  • "videoTitle"
  • "videoUrl"
  • "videoVisible"
  • "visitorRegion"
mergeConflict[].entityInBaseVersion.builtInVariable.name string يشير ذلك المصطلح إلى اسم المتغيّر المضمَّن الذي سيتم استخدامه للإشارة إلى المتغيّر المضمَّن.
mergeConflict[].entityInBaseVersion.gtagConfig nested object إعداد gtag الذي يمثله الكيان.

تجربة

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