REST Resource: assetRelationships
Stay organized with collections
Save and categorize content based on your preferences.
Resource: AssetRelationship
An assetRelationship
resource identifies two related assets in which one asset is treated as a parent (containing) asset and the other is a child (contained) asset. For example, a composition asserted asset contains sound recording assets, and each sound recording asset contains music video assets.
All rights reserved. Java is a registered trademark of Oracle and/or its affiliates.
Last updated 2025-08-20 UTC.
[[["Easy to understand","easyToUnderstand","thumb-up"],["Solved my problem","solvedMyProblem","thumb-up"],["Other","otherUp","thumb-up"]],[["Missing the information I need","missingTheInformationINeed","thumb-down"],["Too complicated / too many steps","tooComplicatedTooManySteps","thumb-down"],["Out of date","outOfDate","thumb-down"],["Samples / code issue","samplesCodeIssue","thumb-down"],["Other","otherDown","thumb-down"]],["Last updated 2025-08-20 UTC."],[[["\u003cp\u003e\u003ccode\u003eAssetRelationship\u003c/code\u003e resources define relationships between two assets, designating one as the parent and the other as the child.\u003c/p\u003e\n"],["\u003cp\u003eThe \u003ccode\u003eAssetRelationship\u003c/code\u003e resource is identified by a unique \u003ccode\u003eid\u003c/code\u003e and specifies the \u003ccode\u003eparentAssetId\u003c/code\u003e and \u003ccode\u003echildAssetId\u003c/code\u003e.\u003c/p\u003e\n"],["\u003cp\u003eThe JSON representation of an \u003ccode\u003eAssetRelationship\u003c/code\u003e includes the fields \u003ccode\u003ekind\u003c/code\u003e, \u003ccode\u003eid\u003c/code\u003e, \u003ccode\u003eparentAssetId\u003c/code\u003e, and \u003ccode\u003echildAssetId\u003c/code\u003e.\u003c/p\u003e\n"],["\u003cp\u003eThree methods are available for \u003ccode\u003eAssetRelationship\u003c/code\u003e resources: \u003ccode\u003edelete\u003c/code\u003e to remove a relationship, \u003ccode\u003einsert\u003c/code\u003e to create a relationship, and \u003ccode\u003elist\u003c/code\u003e to retrieve relationships.\u003c/p\u003e\n"]]],["An `assetRelationship` resource links two assets as parent and child. Each relationship has a unique ID, kind, parent asset ID, and child asset ID. The `kind` identifies the resource type. Actions include `insert` to create a new relationship, `delete` to remove a relationship, and `list` to retrieve existing relationships. Relationships are represented in JSON format with the fields specified above.\n"],null,["# REST Resource: assetRelationships\n\n- [Resource: AssetRelationship](#AssetRelationship)\n - [JSON representation](#AssetRelationship.SCHEMA_REPRESENTATION)\n- [Methods](#METHODS_SUMMARY)\n\nResource: AssetRelationship\n---------------------------\n\nAn `assetRelationship` resource identifies two related assets in which one asset is treated as a parent (containing) asset and the other is a child (contained) asset. For example, a composition asserted asset contains sound recording assets, and each sound recording asset contains music video assets.\n\n| JSON representation |\n|-------------------------------------------------------------------------------------------|\n| ``` { \"kind\": string, \"id\": string, \"parentAssetId\": string, \"childAssetId\": string } ``` |\n\n| Fields ||\n|-----------------|------------------------------------------------------------------------------------------------------------|\n| `kind` | `string` The type of the API resource. For this resource, the value is `youtubePartner#assetRelationship`. |\n| `id` | `string` A value that YouTube assigns and uses to uniquely identify the asset relationship. |\n| `parentAssetId` | `string` The ID of the parent (containing) asset. |\n| `childAssetId` | `string` The ID of the child (contained) asset. |\n\n| Methods ------- ||\n|----------------------------------------------------------------------------|------------------------------------------------------|\n| ### [delete](/youtube/partner/reference/rest/v1/assetRelationships/delete) | Deletes a relationship between two assets. |\n| ### [insert](/youtube/partner/reference/rest/v1/assetRelationships/insert) | Creates a relationship that links two assets. |\n| ### [list](/youtube/partner/reference/rest/v1/assetRelationships/list) | Retrieves a list of relationships for a given asset. |"]]
