Client settings

Configuration

Timeouts, proxies, regions and per-request configuration.

Everything on this page is set on the client and applies to every call made through it.

Timeouts#

Defaults are generous enough for interactive calls but not for large imports or exports. Raise the read timeout before moving large files.

python

# The Python client exposes timeouts through the underlying requests session.
ac.request_timeout = (10, 60)   # (connect, read) in seconds

python

ac.set_proxy("proxy.example.com", "8443", "proxyUser", "proxyPassword")

python

ac.analytics_server_url = "https://analyticsapi.zoho.eu"
ac.accounts_server_url = "https://accounts.zoho.eu"

See Authentication for the full host table.

Most methods take a final config value carrying optional parameters for that endpoint — filter criteria, output format, pagination and so on.

python

# Any extra headers are merged into every request.
ac.default_headers = {"X-Custom-Source": "nightly-sync"}

python

# Supply a token you already hold instead of letting the SDK mint one.
ac.access_token = "1000.xxxxxxx.xxxxxxx"

config defaults to {}; omit it when you have nothing to add.
Streaming variants export_data_stream() and export_bulk_data_stream() return a urllib3 response so large exports never have to be buffered in memory.