Link relation aa:asset-selective-by-id

New in MC | Cloud UX 2022.3

Overview

Returns an aa:asset resource with the information requested in the request body about an asset.

HTTP method

POST

URL template parameters

id

ID of the asset.

Query parameters

lang

Culture code for localized data.

offset, limit

Zero-based number of first row and maximum number of rows to return for aa:multi-value-attribute-range resources in the response. See aa:multi-value-attribute-range-by-attributeid for details.

start, end, segmentids

Filter the segments that are returned for aa:time-based resources in the response. See aa:time-based for details.

insist

Request optional, but requestable properties (comma-separated list). Supported values:

  • insist=totalElements: request getting the property totalElements in paging with the total number of rows for aa:multi-value-attribute-range resources in the response.

refresh

Bypass caches and get the latest, refreshed values. The value is a comma-separated list. Currently, the following values are supported:

  • attributes: forces getting the latest values for attributes.

Request body

Specifies what exactly to get for the asset. See aa:asset-selective request for details. Examples:

{
    "aa:attributes": [
        "COMMENT",
        "VIDEO_ANALYSIS_STATUS"
    ],
    "aa:multi-value-attribute-range": [
        {
            "name": "CONTRIBUTIONS"
        },
        {
            "name": "ATHLETES"
        }
    ],
    "aa:time-based": [
        {
            "name": "VISUAL_CONTENT"
        }
    ]
}

or

{
    "asset-model-layouts": [
        {
            "name": "attributeGroupLayout"
        }
    ]
}

HTTP response

200 OK

403 Forbidden

The caller has no read permission for the asset.

404 Not Found

The asset doesn’t exist or the service or an intermediate resource is not available.

Response body

An aa:asset resource with the information about the asset. Depending on the request, the resource may contain embedded sub resources:

Available in