MetadataBasicUpdate()

Update an existing BasicAsset by ContentID.

API URL:

[BaseURL]/Asset/Metadata/Basic/{ContentID}

Request Method:

PUT

Request Parameters:

• ContentID is the unique identifier for a BasicAsset

Request Format

XML type:

• dece:BasicAsset

Required information:

• BasicAsset
  • BasicData
  • @ContentID
    • LocalizedInfo
      • @Language
      • TitleDisplay19
      • TitleDisplay60
      • TitleSort
      • ArtReference
        • @Resolution
      • Summary190
      • Summary400
      • OriginalTitle
      • CopyrightLine
    • RunLength
    • ReleaseYear
    • WorkType

Optional information:

• BasicAsset
  • BasicData
    • UpdateNum
    • ReleaseDate
    • ReleaseHistory
    • WorkTypeDetail
    • PictureColorType
    • PictureFormat
    • ThreeD
    • AspectRatio
    • AltIdentifier
    • RatingSet
    • People
    • CountryOfOrigin
    • PrimarySpokenLanguage
    • OriginalLanguage
    • VersionLanguage
    • AssociatedOrg
    • SequenceInfo
    • Parent

Response Format

Status Code:

• HTTP 202

Headers:

• Location: [BaseURL]/Asset/Metadata/Basic/{ContentID}?UpdateNum={UpdateNum}

Errors

• ContentIdNotMatchingWiththeXMLContentId
  • ContentID provided in the URL does not match the ContentID in the XML body
  • HTTP Status Code: 400
• UpdateNumIsInvalid
  • UpdateNum provided in the XML body is already in use
  • HTTP Status Code: 400

Example

Update a BasicAsset

The following example updates a BasicAsset to be consumed in the UV ecosystem

Sample Request:

PUT /rest/2015/02/Asset/Metadata/Basic HTTP/1.1
Content-type: application/xml; charset=UTF-8
Host: api.uvvu.com

<?xml version="1.0" encoding="UTF-8"?>
<BasicAsset xmlns="http://www.decellc.org/schema/2015/03/coordinator" xmlns:ns2="http://www.movielabs.com/schema/md/v2.3/md">
  <BasicData ContentID="urn:dece:cid:org:customer-zero:123456789">
    <ns2:UpdateNum>2</ns2:UpdateNum>
    <ns2:LocalizedInfo language="en-US">
      <ns2:TitleDisplay19>cvp_TitleDisplay19</ns2:TitleDisplay19>
      <ns2:TitleDisplay60>TitleDisplay60 - Update</ns2:TitleDisplay60>
      <ns2:TitleSort>cvp_this is title sort for asset</ns2:TitleSort>
      <ns2:ArtReference resolution="800x1200">https://cdn.com/test_800_1200.png</ns2:ArtReference>
      <ns2:ArtReference resolution="840x1200">https://cdn.com/test_840_1200.png</ns2:ArtReference>
      <ns2:ArtReference resolution="192x288">https://cdn.com/test_192_288.jpg</ns2:ArtReference>
      <ns2:ArtReference resolution="224x320">https://cdn.com/test_224_320.jpg</ns2:ArtReference>
      <ns2:ArtReference resolution="112x160">https://cdn.com/test_112_160.jpg</ns2:ArtReference>
      <ns2:Summary190>cvp_this is summary190</ns2:Summary190>
      <ns2:Summary400>cvp_this is summary400</ns2:Summary400>
      <ns2:OriginalTitle>cvp original title</ns2:OriginalTitle>
      <ns2:CopyrightLine>cvp_this is copyright</ns2:CopyrightLine>
    </ns2:LocalizedInfo>
    <ns2:RunLength>P0Y0M0DT1H30M</ns2:RunLength>
    <ns2:ReleaseYear>2011</ns2:ReleaseYear>
    <ns2:WorkType>Short</ns2:WorkType>
  </BasicData>
</BasicAsset>

Sample Response:

HTTP/1.1 202
Date: [Date]
Content-Type: text/plain
Location: [BaseURL]/Asset/Metadata/Basic/urn:dece:cid:org:customer-zero:123456789?UpdateNum=2
X-transaction-info: [TransactionInfo]

MdBasic Update Request has been accepted for processing, but the processing has not been completed

See Also

• MetadataBasicCreate()
• MetadataBasicVerify()
• MetadataBasicList()
• MetadataBasicGet()
• MetadataBasicDelete()