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.

<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?