文档

​
​

Development

User Acquisition

Monetization

工业

Unity Cloud

Get Started

Asset Manager SDKs and services

Open Unity Dashboard

Unity Cloud

此页面不支持所选语言。
​
​
Unity Dashboard
  • Accounts
  • Organizations
  • Projects
  • Products
  • Billing
Developer Data
  • Introduction to the Developer Data Framework
  • Get started
  • View Diagnostics for your project
  • Privacy and consent
Unity Asset Manager
  • What's new
  • Asset Manager web
  • Asset Store
  • Manage Assets in the Editor
  • Unity Version Control
  • Developer documentation
    • Asset Manager SDKs and services
    • Integrations
      • Get started with your Asset Manager integration
      • Unity Cloud Python SDK
        • Prerequisites
        • Get started
        • Security information
        • Manage Identity
        • Manage assets
        • Manage asset versions
        • Manage datasets and files
        • Manage metadata
        • Manage collections
        • Manage transformations
        • Manage asset status
        • Manage VCS integrations
        • Open Dashboard
        • Configure Self-Hosted Deployment
        • Samples
        • Configure logs
        • Troubleshooting
      • Unity Pipeline Automation
      • Asset Manager for Unity Asset Transformer Studio
      • Asset Manager for Blender
Unity Pipeline Automation
  • About
  • Get started
  • Pipelines
  • Automations
  • Monitor jobs
  1. Unity Cloud Documentation
  2. Asset Manager
  3. Unity Cloud Python SDK

Troubleshooting

This section describes issues you might have while using Python SDK.
阅读时间2 分钟
最后更新于 1 年前

General issues

I'm getting some inconsistent behavior when re-initializing
unity_cloud
once it has been disposed

When the Python SDK is disposed and re-initialized multiple times in the same lifetime of an application, some behaviors break. The workaround is to simply avoid disposing of any modules.

I get a "Python quit unexpectedly" error when I run the Python SDK on macOS

When you use the Python SDK with the built-in Python version on macOS, you might encounter a Python quit unexpectedly error. This is a known issue with the system Python version. To prevent it, use a virtual environment or install Python with Homebrew.

Service account issues

Some methods return an exception

When using a service account as the authorization method, some calls to the Python SDK will return errors. Calls to the
identity
module's method will break. This is a known issues and should be resolved in a timely fashion. All calls to the
user_login
module will, in turn, return an invalid operation exception. This is by design as this module becomes unavailable when using the
service_account
module.

I have metadata and field definition errors

When adding a metadata dictionary during any entities creation or update, any error in either the key or the value can result in a validation error from the back-end. Make sure the key passed is the right one.
To identify which key is the right key to use, call unity_cloud.assets.list_field_definitions and inspect your field to get the exact key.
As for value errors, they will depend on the type of the field definition. To avoid these errors, do as follows:
  • For
    select
    and
    multiselect
    fields, make sure you are using an exact value contained in the
    accepted_values
    .
  • For timestamp, the value must be a UTC datetime respecting the ISO 8601 format.
  • For url, the value must be a valid URL beginning with either http:// or https://.
  • For user, the value must be a valid user ID.

Copyright © 2026 Unity Technologies
法律信息隐私政策CookiesDocumentation Terms of Use请勿出售或分享我的个人信息您的隐私选择(Cookie 设置)

“Unity”、Unity 徽标及其他 Unity 商标是 Unity Technologies 或其附属公司在美国和其他地方的商标或注册商标(此处查看更多信息)。其他名称或品牌是其各自所有者的商标。

为方便起见,一些页面是机器翻译的,可能包含不准确的内容。如有信息不一致的情况,以英文版本为准。

  • 在本页上
    • General issues

      • I'm getting some inconsistent behavior when re-initializing unity_cloud once it has been disposed

      • I get a "Python quit unexpectedly" error when I run the Python SDK on macOS

    • Service account issues

      • Some methods return an exception

    • I have metadata and field definition errors


报告此页面的问题