feat: [google-cloud-dialogflow-cx] added Generator API

packages/google-cloud-dialogflow-cx/CONTRIBUTING.rst

@@ -22,7 +22,7 @@ In order to add a feature:
   documentation.
 
 - The feature must work fully on the following CPython versions:
-  3.7, 3.8, 3.9, 3.10 and 3.11 on both UNIX and Windows.
+  3.7, 3.8, 3.9, 3.10, 3.11 and 3.12 on both UNIX and Windows.
 
 - The feature must not add unnecessary dependencies (where
   "unnecessary" is of course subjective, but new dependencies should
@@ -72,7 +72,7 @@ We use `nox <https://nox.readthedocs.io/en/latest/>`__ to instrument our tests.
 
 - To run a single unit test::
 
-    $ nox -s unit-3.11 -- -k <name of test>
+    $ nox -s unit-3.12 -- -k <name of test>
 
 
   .. note::
@@ -143,12 +143,12 @@ Running System Tests
    $ nox -s system
 
    # Run a single system test
-   $ nox -s system-3.11 -- -k <name of test>
+   $ nox -s system-3.12 -- -k <name of test>
 
 
   .. note::
 
-      System tests are only configured to run under Python 3.8, 3.9, 3.10 and 3.11.
+      System tests are only configured to run under Python 3.8, 3.9, 3.10, 3.11 and 3.12.
       For expediency, we do not run them in older versions of Python 3.
 
   This alone will not run the tests. You'll need to change some local
@@ -226,12 +226,14 @@ We support:
 -  `Python 3.9`_
 -  `Python 3.10`_
 -  `Python 3.11`_
+-  `Python 3.12`_
 
 .. _Python 3.7: https://docs.python.org/3.7/
 .. _Python 3.8: https://docs.python.org/3.8/
 .. _Python 3.9: https://docs.python.org/3.9/
 .. _Python 3.10: https://docs.python.org/3.10/
 .. _Python 3.11: https://docs.python.org/3.11/
+.. _Python 3.12: https://docs.python.org/3.12/
 
 
 Supported versions can be found in our ``noxfile.py`` `config`_.

packages/google-cloud-dialogflow-cx/docs/dialogflowcx_v3/generators.rst

@@ -0,0 +1,10 @@
+Generators
+----------------------------
+
+.. automodule:: google.cloud.dialogflowcx_v3.services.generators
+    :members:
+    :inherited-members:
+
+.. automodule:: google.cloud.dialogflowcx_v3.services.generators.pagers
+    :members:
+    :inherited-members:

packages/google-cloud-dialogflow-cx/docs/dialogflowcx_v3/services_.rst

@@ -10,6 +10,7 @@ Services for Google Cloud Dialogflowcx v3 API
     environments
     experiments
     flows
+    generators
     intents
     pages
     security_settings_service

packages/google-cloud-dialogflow-cx/google/cloud/dialogflowcx/__init__.py

@@ -42,6 +42,10 @@
 from google.cloud.dialogflowcx_v3.services.experiments.client import ExperimentsClient
 from google.cloud.dialogflowcx_v3.services.flows.async_client import FlowsAsyncClient
 from google.cloud.dialogflowcx_v3.services.flows.client import FlowsClient
+from google.cloud.dialogflowcx_v3.services.generators.async_client import (
+    GeneratorsAsyncClient,
+)
+from google.cloud.dialogflowcx_v3.services.generators.client import GeneratorsClient
 from google.cloud.dialogflowcx_v3.services.intents.async_client import (
     IntentsAsyncClient,
 )
@@ -196,6 +200,16 @@
 from google.cloud.dialogflowcx_v3.types.fulfillment import Fulfillment
 from google.cloud.dialogflowcx_v3.types.gcs import GcsDestination
 from google.cloud.dialogflowcx_v3.types.generative_settings import GenerativeSettings
+from google.cloud.dialogflowcx_v3.types.generator import (
+    CreateGeneratorRequest,
+    DeleteGeneratorRequest,
+    Generator,
+    GetGeneratorRequest,
+    ListGeneratorsRequest,
+    ListGeneratorsResponse,
+    Phrase,
+    UpdateGeneratorRequest,
+)
 from google.cloud.dialogflowcx_v3.types.import_strategy import ImportStrategy
 from google.cloud.dialogflowcx_v3.types.inline import InlineDestination, InlineSource
 from google.cloud.dialogflowcx_v3.types.intent import (
@@ -366,6 +380,8 @@
     "ExperimentsAsyncClient",
     "FlowsClient",
     "FlowsAsyncClient",
+    "GeneratorsClient",
+    "GeneratorsAsyncClient",
     "IntentsClient",
     "IntentsAsyncClient",
     "PagesClient",
@@ -480,6 +496,14 @@
     "Fulfillment",
     "GcsDestination",
     "GenerativeSettings",
+    "CreateGeneratorRequest",
+    "DeleteGeneratorRequest",
+    "Generator",
+    "GetGeneratorRequest",
+    "ListGeneratorsRequest",
+    "ListGeneratorsResponse",
+    "Phrase",
+    "UpdateGeneratorRequest",
     "ImportStrategy",
     "InlineDestination",
     "InlineSource",

packages/google-cloud-dialogflow-cx/google/cloud/dialogflowcx/gapic_version.py

@@ -13,4 +13,4 @@
 # See the License for the specific language governing permissions and
 # limitations under the License.
 #
-__version__ = "1.29.0"  # {x-release-please-version}
+__version__ = "0.0.0"  # {x-release-please-version}

packages/google-cloud-dialogflow-cx/google/cloud/dialogflowcx_v3/__init__.py

@@ -25,6 +25,7 @@
 from .services.environments import EnvironmentsAsyncClient, EnvironmentsClient
 from .services.experiments import ExperimentsAsyncClient, ExperimentsClient
 from .services.flows import FlowsAsyncClient, FlowsClient
+from .services.generators import GeneratorsAsyncClient, GeneratorsClient
 from .services.intents import IntentsAsyncClient, IntentsClient
 from .services.pages import PagesAsyncClient, PagesClient
 from .services.security_settings_service import (
@@ -154,6 +155,16 @@
 from .types.fulfillment import Fulfillment
 from .types.gcs import GcsDestination
 from .types.generative_settings import GenerativeSettings
+from .types.generator import (
+    CreateGeneratorRequest,
+    DeleteGeneratorRequest,
+    Generator,
+    GetGeneratorRequest,
+    ListGeneratorsRequest,
+    ListGeneratorsResponse,
+    Phrase,
+    UpdateGeneratorRequest,
+)
 from .types.import_strategy import ImportStrategy
 from .types.inline import InlineDestination, InlineSource
 from .types.intent import (
@@ -314,6 +325,7 @@
     "EnvironmentsAsyncClient",
     "ExperimentsAsyncClient",
     "FlowsAsyncClient",
+    "GeneratorsAsyncClient",
     "IntentsAsyncClient",
     "PagesAsyncClient",
     "SecuritySettingsServiceAsyncClient",
@@ -351,6 +363,7 @@
     "CreateEnvironmentRequest",
     "CreateExperimentRequest",
     "CreateFlowRequest",
+    "CreateGeneratorRequest",
     "CreateIntentRequest",
     "CreatePageRequest",
     "CreateSecuritySettingsRequest",
@@ -367,6 +380,7 @@
     "DeleteEnvironmentRequest",
     "DeleteExperimentRequest",
     "DeleteFlowRequest",
+    "DeleteGeneratorRequest",
     "DeleteIntentRequest",
     "DeletePageRequest",
     "DeleteSecuritySettingsRequest",
@@ -411,6 +425,8 @@
     "Fulfillment",
     "GcsDestination",
     "GenerativeSettings",
+    "Generator",
+    "GeneratorsClient",
     "GetAgentRequest",
     "GetAgentValidationResultRequest",
     "GetChangelogRequest",
@@ -421,6 +437,7 @@
     "GetFlowRequest",
     "GetFlowValidationResultRequest",
     "GetGenerativeSettingsRequest",
+    "GetGeneratorRequest",
     "GetIntentRequest",
     "GetPageRequest",
     "GetSecuritySettingsRequest",
@@ -464,6 +481,8 @@
     "ListExperimentsResponse",
     "ListFlowsRequest",
     "ListFlowsResponse",
+    "ListGeneratorsRequest",
+    "ListGeneratorsResponse",
     "ListIntentsRequest",
     "ListIntentsResponse",
     "ListPagesRequest",
@@ -494,6 +513,7 @@
     "Page",
     "PageInfo",
     "PagesClient",
+    "Phrase",
     "QueryInput",
     "QueryParameters",
     "QueryResult",
@@ -550,6 +570,7 @@
     "UpdateExperimentRequest",
     "UpdateFlowRequest",
     "UpdateGenerativeSettingsRequest",
+    "UpdateGeneratorRequest",
     "UpdateIntentRequest",
     "UpdatePageRequest",
     "UpdateSecuritySettingsRequest",

packages/google-cloud-dialogflow-cx/google/cloud/dialogflowcx_v3/gapic_metadata.json

@@ -828,6 +828,100 @@
         }
       }
     },
+    "Generators": {
+      "clients": {
+        "grpc": {
+          "libraryClient": "GeneratorsClient",
+          "rpcs": {
+            "CreateGenerator": {
+              "methods": [
+                "create_generator"
+              ]
+            },
+            "DeleteGenerator": {
+              "methods": [
+                "delete_generator"
+              ]
+            },
+            "GetGenerator": {
+              "methods": [
+                "get_generator"
+              ]
+            },
+            "ListGenerators": {
+              "methods": [
+                "list_generators"
+              ]
+            },
+            "UpdateGenerator": {
+              "methods": [
+                "update_generator"
+              ]
+            }
+          }
+        },
+        "grpc-async": {
+          "libraryClient": "GeneratorsAsyncClient",
+          "rpcs": {
+            "CreateGenerator": {
+              "methods": [
+                "create_generator"
+              ]
+            },
+            "DeleteGenerator": {
+              "methods": [
+                "delete_generator"
+              ]
+            },
+            "GetGenerator": {
+              "methods": [
+                "get_generator"
+              ]
+            },
+            "ListGenerators": {
+              "methods": [
+                "list_generators"
+              ]
+            },
+            "UpdateGenerator": {
+              "methods": [
+                "update_generator"
+              ]
+            }
+          }
+        },
+        "rest": {
+          "libraryClient": "GeneratorsClient",
+          "rpcs": {
+            "CreateGenerator": {
+              "methods": [
+                "create_generator"
+              ]
+            },
+            "DeleteGenerator": {
+              "methods": [
+                "delete_generator"
+              ]
+            },
+            "GetGenerator": {
+              "methods": [
+                "get_generator"
+              ]
+            },
+            "ListGenerators": {
+              "methods": [
+                "list_generators"
+              ]
+            },
+            "UpdateGenerator": {
+              "methods": [
+                "update_generator"
+              ]
+            }
+          }
+        }
+      }
+    },
     "Intents": {
       "clients": {
         "grpc": {

packages/google-cloud-dialogflow-cx/google/cloud/dialogflowcx_v3/gapic_version.py

@@ -13,4 +13,4 @@
 # See the License for the specific language governing permissions and
 # limitations under the License.
 #
-__version__ = "1.29.0"  # {x-release-please-version}
+__version__ = "0.0.0"  # {x-release-please-version}