By default, global widgets apply to all sites in your Commerce Cloud instance. You may override this default and assign a global widget to be used on only specified sites. To do this, you issue a POST request using the updateSiteAssociations custom action of the widgetDescriptors resource and provide a list of sites in a sites property. For example, the following request updates myGlobalWidget to execute on siteA and siteB only.
POST /ccadmin/v1/widgetDescriptors/myGlobalWidget/updateSiteAssociations
{
"sites": ["siteA", "siteB"]
}To remove site associations, issue a POST request using the same custom action with the sites property set to null:
POST /ccadmin/v1/widgetDescriptors/myGlobalWidget/updateSiteAssociations
{
"sites": []
}The following is an example response for a call made using the updateSiteAssociations custom action:
{
"result": true,
"links": [
{
"rel": "self",
"href":
http://localhost:9080/ccadmin/v1/widgetDescriptors/recommendationsTracking_v1/
updateSiteAssociations"
}
]
}Note that any attempt to update site associations for a widget that is not global results in an error, as will attempting to associate a global widget with a site whose ID does not exist.
