diff --git a/texttospeech/docs/api.rst b/texttospeech/docs/api.rst index 32998d183a9a..8dd5fb3fdda2 100644 --- a/texttospeech/docs/api.rst +++ b/texttospeech/docs/api.rst @@ -1,31 +1,30 @@ -API Reference -============= +Text-to-Speech Client API Reference +=================================== -APIs ----- +This package includes clients for multiple versions of the Text-to-Speech +API. By default, you will get ``v1``, the latest GA version. -.. autosummary:: +.. toctree:: + :maxdepth: 2 -.. :toctree:: + gapic/v1/api + gapic/v1/types - google.cloud.texttospeech_v1.trace_service_client +If you are interested in beta features ahead of the latest GA, you may +opt-in to the v1.1 beta, which is spelled ``v1beta1``. In order to do this, +you will want to import from ``google.cloud.texttospeech_v1beta1`` in lieu of +``google.cloud.texttospeech``. +An API and type reference is provided for the v1.1 beta also: -API types -~~~~~~~~~ +.. toctree:: + :maxdepth: 2 -.. autosummary:: -.. :toctree:: + gapic/v1beta1/api + gapic/v1beta1/types - google.cloud.trace_v1 - - -API types -~~~~~~~~~ - -.. autosummary:: -.. :toctree:: - - google.cloud.trace_v1.gapic.enums - google.cloud.trace_v1.gapic.types +.. note:: + The client for the beta API is provided on a provisional basis. The API + surface is subject to change, and it is possible that this client will be + deprecated or removed after its features become GA.