Message Header

These features are only available to partners using YouTube's Content Manager to manage their copyrighted content.

YouTube has three registered DPids:

  • YouTube - PADPIDA2013020802I
  • YouTube_ContentID - PADPIDA2015120100H
  • YouTube_CreatorMusic - PADPIDA2022021109P

The header identifies both the sender (you) and the recipient (YouTube) by their unique DDEX Party ID (DPid).

  • To deliver content for YouTube Premium only, use YouTube (PADPIDA2013020802I) as the MessageRecipient.
  • To deliver content for Content ID only, use YouTube_ContentID (PADPIDA2015120100H) as the MessageRecipient.
  • To use the same feed to deliver content for both YouTube Premium and Content ID, include both YouTube and YouTube_ContentID as MessageRecipients. Please note that multiple MessageRecipients were added to the ERN message in v3.7.
  • To deliver license strategies for Creator Music only, use YouTube_CreatorMusic (PADPIDA2022021109P) as the MessageRecipient.
    • Note: The related sound recording asset should already exist in Content Manager.
  • To use the same feed to deliver content for both YouTube Premium and Content ID with Creator Music license strategies, you must include YouTube, YouTube_ContentID, and YouTube_CreatorMusic as MessageRecipients.

The example below shows how to address a feed to both YouTube and YouTube_ContentID.

Example 1
<MessageHeader>
    <MessageThreadId>1</MessageThreadId>
    <MessageId>9543BD3607862A82E04400144FEAB9A6</MessageId>
    <MessageSender>
        <PartyId>PADPIDAZZZZXXXXXXU</PartyId>
        <PartyName>
            <FullName>ABC Label</FullName>
        </PartyName>
    </MessageSender>
    <MessageRecipient>
        <PartyId>PADPIDA2013020802I</PartyId>
        <PartyName>
            <FullName>YouTube</FullName>
        </PartyName>
    </MessageRecipient>
    <MessageRecipient>
        <PartyId>PADPIDA2015120100H</PartyId>
        <PartyName>
            <FullName>YouTube_ContentID</FullName>
        </PartyName>
    </MessageRecipient>
    <MessageCreatedDateTime>2011-02-03T09:57:14Z</MessageCreatedDateTime>
    <MessageControlType>LiveMessage</MessageControlType>
</MessageHeader>

If you are delivering content for a third party, use the <SentOnBehalfOf> element to provide the DPid of the third party. The third party must be a registered YouTube partner, and must already be linked to your YouTube Content Manager account (by your partner representative). All assets created will be linked to the third party’s account.

Example 2
<MessageHeader>
    <MessageThreadId>1</MessageThreadId>
    <MessageId>9543BD3607862A82E04400144FEAB9A6</MessageId>
    <MessageSender>
        <PartyId>PADPIDAZZZZXXXXXXU</PartyId>
        <PartyName>
            <FullName>XYZ aggregator</FullName>
        </PartyName>
    </MessageSender>
    <SentOnBehalfOf>
        <PartyId>PADPIDAZZZZZZZZZZU</PartyId>
        <PartyName>
            <FullName>ACME label</FullName>
        </PartyName>
    </SentOnBehalfOf>
    <MessageRecipient>
        <PartyId>PADPIDA2013020802I</PartyId>
        <PartyName>
            <FullName>YouTube</FullName>
        </PartyName>
    </MessageRecipient>
    <MessageCreatedDateTime>2011-02-03T09:57:14Z</MessageCreatedDateTime>
</MessageHeader>

Was this helpful?

How can we improve it?
Search
Clear search
Close search
Google apps
Main menu
3409087449157227574
true
Search Help Center
true
true
true
true
true
59
false
false