Manage assets

How to add and manage assets with Python SDK.

Read time 8 minutes
Last updated 7 months ago

Before you start
Before you start

To access any assets, make sure the app has the right permissions. Read more about managing Identity.

Create an asset
Create an asset

To add an asset into a project, follow these steps:

  1. Use the method create_asset by passing all the information inside AssetCreation.
  2. At least define Name and Type values to create an asset. The possible values for Type are:
    • 2D Asset
    • 3D Model
    • Audio
    • Material
    • Script
    • Video
    • Unity Editor
    • Other

The created asset is saved as a draft.

    asset_creation = AssetCreation(
        name = "your-asset-name",
        description = "your-asset-description",
        type = unity_cloud.assets.AssetType.MODEL_3D,
        tags = ["your-tag-1", "your-tag-2", "your-tag-3"]
    )

    asset = unity_cloud.assets.create_asset(
        asset_creation = asset_creation,
        org_id = "012345678912",
        project_id = "1234abcd-ab12-cd34-ef56-123456abcdef"
    )

Update an asset
Update an asset

To change the name, the description, the type, the tags, or the file used for the preview you need to:

  1. Create an AssetUpdate method.
  2. Call the update_asset method.
    asset_update = AssetUpdate(
        name = "your-asset-name",
        description = "your-asset-description",
        type = unity_cloud.assets.AssetType.MODEL_3D,
        tags = ["your-tag-1", "your-tag-2", "your-tag-3"],
        preview_file = "Path/To/File.ext"
    )

    unity_cloud.assets.update_asset(
        asset_update = asset_update,
        org_id = "012345678912",
        project_id = "1234abcd-ab12-cd34-ef56-123456abcdef",
        asset_id = "0123456789abcdefghijklmn",
        asset_version = '1234abcd-ab12-cd34-ef56-123456abcdef'
    )

Get an asset
Get an asset

To fetch a single asset, call get_asset.

    asset = unity_cloud.assets.get_asset(
        org_id = "012345678912",
        project_id = "1234abcd-ab12-cd34-ef56-123456abcdef",
        asset_id = "0123456789abcdefghijklmn",
        asset_version = '1234abcd-ab12-cd34-ef56-123456abcdef'
    )

Get an asset by its label
Get an asset by its label

When the version of the asset is not known, you can fetch an asset by its label using the get_asset_by_label method. Keep the label parameter empty to fetch the default version of the asset.

    asset = unity_cloud.assets.get_asset_by_label(
        org_id = "012345678912",
        project_id = "1234abcd-ab12-cd34-ef56-123456abcdef",
        asset_id = "0123456789abcdefghijklmn",
        label = "your-asset-label"
    )

Get a list of all assets within a project
Get a list of all assets within a project

To fetch all assets contained in a given project, call get_asset_list.

    assets = unity_cloud.assets.get_asset_list(
        org_id = "012345678912",
        project_id = "1234abcd-ab12-cd34-ef56-123456abcdef"
    )

Perform an advanced search for assets
Perform an advanced search for assets

To search for assets across an organization, follow these steps:

  1. Create your filters as dictionnaries or objects that will contain the conditions.
  2. Create an array that will contain the projects in which to look up. Leave the array empty to search across all projects in the organization.
  3. Create an array that will contain the collections in which to look up. Leave the array empty to search across all collections and assets not linked to a collection.
  4. Call search_assets_in_projects with the organization ID, your project IDs, your filters, the amount of matches required in the any_filter, the collections, and optionally the maximum number of results returned and the amount to skip for paging purpose.
include_filter = dict()
exclude_filter = dict()
any_filter = dict()

include_filter[SearchableProperties.NAME] = StringFilter(StringLookUpTypes.REGEX, "asset\-.*")

project_ids = []
collections = []

search_result = unity_cloud.assets.search_assets_in_projects(org_id, project_ids, include_filter = include_filter, exclude_filter = exclude_filter, any_filter = any_filter, any_query_minimum_match = 1, collections = collections, limit_to = 10, skip = 0)

Create filter for a search query
Create filter for a search query

To create an include_filter, an exclude_filter, or an any_filter, you can use the enum SearchableProperties as a helper. This enum is provided with a comment on how each each properties should be created. You are not limited to properties in this enum and can write your own, as long as the properties you're writing exist either in an asset, dataset, or file.

To create a filter on a string property, you can either write a simple equal condition, or use an advanced StringFilter.

include_filter = dict()
include_filter[SearchableProperties.DESCRIPTION] = "Description must be exactly equals to this"
include_filter[SearchableProperties.NAME] = StringFilter(StringLookUpTypes.wildcard, "incompl*te n*me")

To create a filter on a date property, you can either write a simple equal condition, or use an advanced DateRangeCondition. Date must be passed.

date_to_compare = datetime.now().isoformat()

exclude_filter = dict()
exclude_filter[SearchableProperties.DATASETS_CREATED] = date_to_compare
exclude_filter[SearchableProperties.FILES_UPDATED] = DateRangeCondition(DateConditionTypes.LESS_THAN, date_to_compare)

To link assets to multiple projects, use the link_assets_to_project method with the project_id argument.

    unity_cloud.assets.link_asset_to_project(
        org_id = "012345678912",
        project_id = "1234abcd-ab12-cd34-ef56-123456abcdef",
        asset_ids = ["0123456789abcdefghijklmn"],
        new_project_id = "4567efgh-ab12-cd34-ef56-123456abcdef"
    )

To remove assets link to multiple projects, use the unlink_assets_from_project method with the project_id argument.


    unity_cloud.assets.unlink_asset_from_project(
        org_id = "012345678912",
        project_id = "1234abcd-ab12-cd34-ef56-123456abcdef",
        asset_ids = ["0123456789abcdefghijklmn"]
    )

Get an asset preview file URL
Get an asset preview file URL

To get the URL of the preview file of an asset, use the get_preview_file_url method.

    preview_file_url = unity_cloud.assets.get_preview_file_url(
        org_id = "012345678912",
        project_id = "1234abcd-ab12-cd34-ef56-123456abcdef",
        asset_id = "0123456789abcdefghijklmn",
        asset_version = '1234abcd-ab12-cd34-ef56-123456abcdef'
    )

Add an asset reference to an asset
Add an asset reference to an asset

To add a reference to an asset, use the add_asset_reference method. You can either add a reference by using an asset version or a version label assigned to it.

    unity_cloud.assets.add_asset_reference(
        org_id = "012345678912",
        project_id = "1234abcd-ab12-cd34-ef56-123456abcdef",
        source_asset_id = "0123456789abcdefghijklmn",
        source_asset_version = '1234abcd-ab12-cd34-ef56-123456abcdef',
        target_asset_id = "4567efgh-ab12-cd34-ef56-123456abcdef",
        target_asset_version = '4567efgh-ab12-cd34-ef56-123456abcdef',
        target_asset_label = "your-asset-label"
    )

List the references of an asset
List the references of an asset

To list the references of an asset, use the list_asset_references method. The context parameter can be Context.SOURCE, Context.TARGET or Context.BOTH if you want everything.

    references = unity_cloud.assets.list_asset_references(
        org_id = "012345678912",
        project_id = "1234abcd-ab12-cd34-ef56-123456abcdef",
        asset_id = "0123456789abcdefghijklmn",
        asset_version = '1234abcd-ab12-cd34-ef56-123456abcdef',
        context = Context.SOURCE
    )

Remove an asset reference
Remove an asset reference

Using the result of the previous method, you can remove a reference to an asset by using the remove_asset_reference method with the id of a reference.

    unity_cloud.assets.remove_asset_reference(
        org_id = "012345678912",
        project_id = "1234abcd-ab12-cd34-ef56-123456abcdef",
        asset_id = "0123456789abcdefghijklmn",
        asset_version = '1234abcd-ab12-cd34-ef56-123456abcdef',
        reference_id = "4567efgh-ab12-cd34-ef56-123456abcdef"
    )