New Endpoint in Advertising Available: MediaAssetSummary

The MediaAssetSummary endpoint improves performance and reduces unnecessary data transfer when only basic information is required.

Effective Version:

This change will be live in iMIS EMS 20.3.219, which is scheduled to be released at the beginning of January 2026.

What’s New

The MediaAssetSummary endpoint returns only essential metadata for a media asset, such as:

IsPubliclyAvailable
MediaAssetId
MediaAssetName
MediaCode
ProductCode
DefaultFlightDateSpan

This avoids retrieving the full MediaAsset data contract, improving efficiency and reducing payload size.

Available Operations

The new endpoint supports two GET requests and one metadata request:

GET - Retrieve MediaAssetSummary List:

Request Endpoint:

GET /MediaAssetSummary?limit=1

Response:

{
  "$type": "Asi.Soa.Core.DataContracts.PagedResult`1[[Asi.Soa.Media.DataContracts.MediaAssetSummaryData, Asi.Contracts]], Asi.Contracts",
  "Items": {
    "$type": "System.Collections.ObjectModel.Collection`1[[Asi.Soa.Media.DataContracts.MediaAssetSummaryData, Asi.Contracts]], mscorlib",
    "$values": [
      {
        "$type": "Asi.Soa.Media.DataContracts.MediaAssetSummaryData, Asi.Contracts",
        "MediaAssetId": 7,
        "MediaAssetName": "Sample Advertising Journal",
        "ProductCode": "SLP",
        "MediaCode": "SAJ",
        "DefaultFlightDateSpan": "Month"
      }
    ]
  },
  "Offset": 0,
  "Limit": 1,
  "Count": 1,
  "TotalCount": 4,
  "NextPageLink": null,
  "HasNext": true,
  "NextOffset": 1
}

GET - Retrieve MediaAssetSummary by ID:

Request Endpoint:

GET /MediaAssetSummary/{MediaAssetId}

Response:

{
    "$type": "Asi.Soa.Media.DataContracts.MediaAssetSummaryData, Asi.Contracts",
    "MediaAssetId": 7,
    "MediaAssetName": "Sample Advertising Journal",
    "ProductCode": "SLP",
    "MediaCode": "SAJ",
    "DefaultFlightDateSpan": "Month"
}

GET – Retrieve Metadata:

Request Endpoint:

GET /metadata/MediaAssetSummary

Response:

{
    "$type": "Asi.Soa.Core.DataContracts.EntityDefinitionData, Asi.Contracts",
    "Description": "MediaAssetSummary",
    "EntityTypeName": "MediaAssetSummary",
    "Properties": {
        "$type": "Asi.Soa.Core.DataContracts.EntityPropertyDefinitionDataCollection, Asi.Contracts",
        "$values": [
            {
                "$type": "Asi.Soa.Core.DataContracts.PropertyTypeIntegerData, Asi.Contracts",
                "PropertyTypeName": "Integer",
                "Name": "MediaAssetId",
                "Caption": "MediaAssetId",
                "Visible": true
            },
            {
                "$type": "Asi.Soa.Core.DataContracts.PropertyTypeStringData, Asi.Contracts",
                "PropertyTypeName": "String",
                "Name": "MediaAssetName",
                "Caption": "MediaAssetName",
                "Visible": true
            },
            {
                "$type": "Asi.Soa.Core.DataContracts.PropertyTypeStringData, Asi.Contracts",
                "PropertyTypeName": "String",
                "Name": "ProductCode",
                "Caption": "ProductCode",
                "Visible": true
            },
            {
                "$type": "Asi.Soa.Core.DataContracts.PropertyTypeBooleanData, Asi.Contracts",
                "PropertyTypeName": "Boolean",
                "Name": "IsPubliclyAvailable",
                "Caption": "IsPubliclyAvailable",
                "Visible": true
            },
            {
                "$type": "Asi.Soa.Core.DataContracts.PropertyTypeStringData, Asi.Contracts",
                "PropertyTypeName": "String",
                "Name": "MediaCode",
                "Caption": "MediaCode",
                "Visible": true
            },
            {
                "$type": "Asi.Soa.Core.DataContracts.PropertyTypeStringData, Asi.Contracts",
                "PropertyTypeName": "String",
                "Name": "DefaultFlightDateSpan",
                "Caption": "DefaultFlightDateSpan",
                "Visible": true
            }
        ]
    },
    "RelatedEntities": {
        "$type": "Asi.Soa.Core.DataContracts.RelatedEntityDataCollection, Asi.Contracts",
        "$values": []
    },
    "Indexes": {
        "$type": "Asi.Soa.Core.DataContracts.IndexDataCollection, Asi.Contracts",
        "$values": []
    }
}

Impact:

With this update, MediaAssetSummary provides only the essential metadata for a media asset, improving performance and reducing data transfer. The full MediaAsset data contract is not retrieved.