{"id":28377,"library":"tencentcloud-sdk-python-youmall","title":"Tencent Cloud Youmall SDK for Python","description":"The Tencent Cloud Youmall SDK enables developers to manage and interact with Tencent Cloud's Youmall (Tencent Youmall) services. Version 3.0.1416 is part of the v3 SDK which offers consistent client interfaces, but it has no active releases since 2021 and should be considered maintenance-only. The preferred way to use Tencent Cloud services is via the unified tencentcloud-sdk-python with the corresponding product module.","status":"maintenance","version":"3.0.1416","language":"python","source_language":"en","source_url":"https://github.com/TencentCloud/tencentcloud-sdk-python","tags":["tencentcloud","youmall","sdk","cloud","ai"],"install":[{"cmd":"pip install tencentcloud-sdk-python-youmall","lang":"bash","label":"Install legacy SDK"},{"cmd":"pip install tencentcloud-sdk-python-common tencentcloud-sdk-python-youmall","lang":"bash","label":"Install with common module"}],"dependencies":[{"reason":"Required for request signing and base client","package":"tencentcloud-sdk-python-common","optional":false}],"imports":[{"note":"The v20180228 API version is required for the correct client module path.","wrong":"from tencentcloud.youmall import client","symbol":"youmall_client","correct":"from tencentcloud.youmall.v20180228 import youmall_client"},{"note":"Models module is also under the versioned path.","wrong":"from tencentcloud.youmall import models","symbol":"models","correct":"from tencentcloud.youmall.v20180228 import models"}],"quickstart":{"code":"import os\nfrom tencentcloud.common import credential\nfrom tencentcloud.common.exception.tencent_cloud_sdk_exception import TencentCloudSDKException\nfrom tencentcloud.youmall.v20180228 import youmall_client, models\n\ntry:\n    cred = credential.Credential(\n        os.environ.get('TENCENTCLOUD_SECRET_ID', ''),\n        os.environ.get('TENCENTCLOUD_SECRET_KEY', '')\n    )\n    client = youmall_client.YoumallClient(cred, 'ap-guangzhou')\n    req = models.DescribePersonInfoRequest()\n    req.CompanyId = 'your_company_id'\n    resp = client.DescribePersonInfo(req)\n    print(resp.to_json_string())\nexcept TencentCloudSDKException as err:\n    print(err)","lang":"python","description":"Initialize the Youmall client and call a sample API. Replace CompanyId with your actual value."},"warnings":[{"fix":"Check the Tencent Cloud documentation for the latest service availability and use the recommended SDK.","message":"This SDK is no longer actively maintained. No new features or API updates have been released since 2021. Consider migrating to the unified tencentcloud-sdk-python (if a Youmall module exists) or using the HTTP API directly.","severity":"deprecated","affected_versions":">=3.0.0"},{"fix":"Update imports to include the versioned path, e.g., from tencentcloud.youmall.v20180228 import youmall_client","message":"The v3 SDK changed import paths to include the API version (e.g., v20180228). Older code using flat imports will break.","severity":"breaking","affected_versions":">=3.0.0"},{"fix":"Ensure Youmall service is enabled in the Tencent Cloud console and that your API keys have the necessary permissions.","message":"The SDK requires an active Tencent Cloud account and the Youmall service to be enabled. Without proper service activation, API calls will fail with auth or not-enabled errors.","severity":"gotcha","affected_versions":"all"}],"env_vars":null,"last_verified":"2026-05-09T00:00:00.000Z","next_check":"2026-08-07T00:00:00.000Z","problems":[{"fix":"Install the package: pip install tencentcloud-sdk-python-youmall. Also ensure you have the common module: pip install tencentcloud-sdk-python-common. Import from the versioned path: from tencentcloud.youmall.v20180228 import youmall_client","cause":"The SDK package is not installed or the import path is incorrect.","error":"ModuleNotFoundError: No module named 'tencentcloud.youmall'"},{"fix":"Verify your TencentCloud API credentials and set TENCENTCLOUD_SECRET_ID and TENCENTCLOUD_SECRET_KEY environment variables. Alternatively, pass them directly to the Credential constructor.","cause":"The provided SecretId/SecretKey are invalid or not set as environment variables.","error":"tencentcloud.common.exception.tencent_cloud_sdk_exception.TencentCloudSDKException: [TencentCloudSDKException] code:AuthFailure.SecretIdNotFound - The SecretId is not found, please check your SecretId"},{"fix":"Use a valid region such as 'ap-guangzhou' or 'ap-shenzhen-fsi'. Check the Tencent Cloud region documentation for supported regions.","cause":"The region passed to the client constructor is not supported by Youmall service.","error":"tencentcloud.common.exception.tencent_cloud_sdk_exception.TencentCloudSDKException: code:UnsupportedRegion - the region is not supported"},{"fix":"Use: from tencentcloud.youmall.v20180228 import models","cause":"The models module is not imported correctly; likely the import path is missing the 'v20180228' part.","error":"AttributeError: module 'tencentcloud.youmall.v20180228' has no attribute 'models'"}],"ecosystem":"pypi","meta_description":null,"install_score":null,"install_tag":null,"quickstart_score":null,"quickstart_tag":null}