DFS 8.0.2 - 4 Accessing metadata through API

We do not recommend that you access raw fields on the item directly, we recommend to use our api to retrieve metadata.
The api will return a well define model of type AssetMetadata which contains the following properties and methods:

Property name	Type	Description
Name	String	The title of the asset.
Description	String	The description of the asset.
AssetId	Int	This is a unique id coming from the DAM Center.
AssetTypeId	Int	This is a unique id, representing what kind of type the asset is. Ex. images equals 4 and video equals 1 etc. This id can be mapped to an item in this location:system/modules/Digizuite/[silo id]/AssetTypeRoot
AssetTypeName	String	The name of the asset type.
AssetSiloId	String	The Sitecore itemId of the silo this asset is part of.
AssetSiloName	String	The Sitecore item name of the silo this asset is part of.
ImportedBy	String	The name of the user who uploaded the asset.
CreatedDateTime	DateTime	The upload date.
ChangedDateTime	DateTime	The change date.
Filesize	Long	The file size of the original file in bytes.
Filesizeabreviated	String	A more readable version of the file size ex. 606.34 KB
Extension	String	The extension of the original file.
VideoLength	String	Is the asset being of type video, this is the length of the video.
VideoWidth	Int	The width of the original file.
VideoHeight	Int	The height of the original file.
VideoFps	Float	The frames per seconds of the original file.
ImageWidth	Int	The width of the original file.
ImageHeight	Int	The height of the original file.
ImageDpi	Int	The dpi of the original file.
DynamicMetadata	IDictionary<string, string>	This dictionary will contain all the dynamic metafield from the DAM Center. The key is the MetafieldId of the metafield. All metafields can be found either in DAM Center or at this location in Sitecore:system/modules/Digizuite/[silo id]/MetaGroupRoot.

Method name	Description	Ex. of return value
GetMediaUrl()	Returns the media URL for the source file.	/media/512ffeba519249ff866095d7a25846ec/1-source
GetMediaUrl(string mediaFormatId, int resizeWidth = 0, int resizeHeight = 0, bool keepAspectRatio = true, bool allowUpScale = false))	Returns a media URL for the specified quality (mediaFormatId). You have the opportunity resize the image. By default the keepAspectRation is true and allowUpScale is false.	/media/512ffeba519249ff866095d7a25846ec/1-50044/resize/100x0/options/keepaspectratio
GetDownloadUrl()	Returns the download URL for the source file.	/media/512ffeba519249ff866095d7a25846ec/1-source/options/download
GetDownloadUrl(string mediaFormatId)	Returns the download URL for the specified quality (mediaFormatId).	/media/512ffeba519249ff866095d7a25846ec/1-50044/options/download
GetDigizuiteStreamingUrl(string mediaFormatId)	Returns the direct streaming URL to Digizuite. Use this for video streams, can also be used for other types. If you use it for the type image, be aware that it does not use Sitecore cache. The link will contain a access token, which will expire, the default value is 24 hours.	https://[DIGIZUITE URL]/Dmm3BWSV3/assetstream.aspx?assetid=23&mediaformatid=50052&destinationid=10010&accesskey=f0b020bc-81e3-4824-82e3-2e6c1d8f714c

3.5.1 How to retrieve metadata for the field type Asset

AssetField assetField = Sitecore.Context.Item.Fields["Asset"]; 
var name = assetField.AssetMetadata.Name; 
var htmlRender = assetField.RenderAsset();

3.5.2 How to retrieve metadata for the field type AssetLink

AssetlinkField assetLinkField = Sitecore.Context.Item.Fields["AssetLink"]; 
var name = assetLinkField.AssetMetadata.Name; 
var htmlRenderLink = assetLinkField.RenderAsset();

3.5.3 How to retrieve metadata for the field type AssetList

AssetlistField assetList = Sitecore.Context.Item.Fields["AssetList"];
if (assetList != null)
{
	foreach (var asset in assetList.Assets)
		{
		// To request the rendering html for the asset you call the
		// RenderAsset method. It returns an RenderFieldResult object
		var renderResultItem = asset.RenderAsset(); 
		var title = asset.AssetMetadata.Name;
		var id = asset.AssetMetadata.AssetId;
		var assetTypeId = asset.AssetMetadata.AssetTypeId;
		var assetTypeName = asset.AssetMetadata.AssetTypeName; 


		// Get dynamic metadata
		var someDynamicMetadata = asset.AssetMetadata["50343"];
	}
}

3.5.4 Update asset metadata not supported from code

Updating an items metadata is not supported from code. Use the editor in the DAM Explorer or Asset browser.