{"id":28369,"library":"tencentcloud-sdk-python-tiw","title":"Tencent Cloud Tiw SDK","description":"The Tencent Cloud Tiw SDK for Python provides access to Tencent Interactive Whiteboard (TIW) services. Version 3.1.59 is the latest stable release. The package is part of the larger tencentcloud-sdk-python ecosystem and follows the same release cadence as other Tencent Cloud SDK modules.","status":"active","version":"3.1.59","language":"python","source_language":"en","source_url":"https://github.com/TencentCloud/tencentcloud-sdk-python","tags":["tencentcloud","tiw","interactive-whiteboard","cloud-sdk"],"install":[{"cmd":"pip install tencentcloud-sdk-python-tiw","lang":"bash","label":"Install via pip"}],"dependencies":[{"reason":"Required for all Tencent Cloud SDK operations (authentication, HTTP client, etc.)","package":"tencentcloud-sdk-python-common","optional":false}],"imports":[{"note":"The old import path was flat; now you must specify the API version in the module path.","wrong":"from tencentcloud.tiw import TiwClient","symbol":"TiwClient","correct":"from tencentcloud.tiw.v20190919 import tiw_client"}],"quickstart":{"code":"import os\nfrom tencentcloud.common import credential\nfrom tencentcloud.common.exception.tencent_cloud_sdk_exception import TencentCloudSDKException\nfrom tencentcloud.tiw.v20190919 import tiw_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 = tiw_client.TiwClient(cred, 'ap-guangzhou')\n    req = models.DescribeWhiteboardPushRequest()\n    req.SdkAppId = 'your_sdkappid'\n    req.TaskId = 'your_task_id'\n    resp = client.DescribeWhiteboardPush(req)\n    print(resp.to_json_string())\nexcept TencentCloudSDKException as err:\n    print(err)","lang":"python","description":"Initialize the Tiw client and call DescribeWhiteboardPush as an example."},"warnings":[{"fix":"Use from tencentcloud.tiw.v20190919 import tiw_client, models","message":"The import path changed between SDK v2 and v3. In v2, you could import directly from tencentcloud.tiw; in v3, you must include the version subpackage (v20190919).","severity":"breaking","affected_versions":">=3.0.0"},{"fix":"Use the latest request models from the appropriate version subpackage.","message":"The DescribeWhiteboardPushRequest and similar request objects are deprecated in favor of new request models in later API versions (e.g., v20200903?). Check the latest API documentation.","severity":"deprecated","affected_versions":">=3.1.50"},{"fix":"Verify supported regions in the Tencent Cloud documentation; typically 'ap-guangzhou', 'ap-shanghai', etc.","message":"Region selection matters: the Tiw API may not be available in all regions. Using an unsupported region will cause a client error.","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":"pip install tencentcloud-sdk-python-common","cause":"The base tencentcloud-sdk-python-common package is not installed.","error":"ModuleNotFoundError: No module named 'tencentcloud'"},{"fix":"Update to the latest API version: check the Tencent Cloud documentation and adjust the import path accordingly (e.g., v20200903).","cause":"The API version (e.g., v20190919) is not supported for the specific TIW operation.","error":"tencentcloud.common.exception.TencentCloudSDKException: [TencentCloudSDKException] code: UnsupportedOperation, message: The requested API version is not supported"}],"ecosystem":"pypi","meta_description":null,"install_score":null,"install_tag":null,"quickstart_score":null,"quickstart_tag":null}