chore: [google-cloud-dialogflow-cx] regenerate API index (#12644)

BEGIN_COMMIT_OVERRIDE chore: rename Longrunning package name for PHP END_COMMIT_OVERRIDE - [ ] Regenerate this pull request now. Source-Link: googleapis/googleapis@acf5e8a Source-Link: googleapis/googleapis-gen@25f2e93 Copy-Tag: eyJwIjoicGFja2FnZXMvZ29vZ2xlLWNsb3VkLWRpYWxvZ2Zsb3ctY3gvLk93bEJvdC55YW1sIiwiaCI6IjI1ZjJlOTMwYzhlZDgxOTgzNDZhYTc0NmU5M2NjYjg2ZDY5MTMwYzkifQ== BEGIN_NESTED_COMMIT chore: [google-cloud-dialogflow-cx] rename Longrunning package name for PHP PiperOrigin-RevId: 629107810 Source-Link: googleapis/googleapis@f306b95 Source-Link: googleapis/googleapis-gen@780ee3d Copy-Tag: eyJwIjoicGFja2FnZXMvZ29vZ2xlLWNsb3VkLWRpYWxvZ2Zsb3ctY3gvLk93bEJvdC55YW1sIiwiaCI6Ijc4MGVlM2RlMjRjZjYxMmM0ZmVmYmJhNDM1Yjg4NWUxZmY2NmY4MmQifQ== END_NESTED_COMMIT --------- Co-authored-by: Owl Bot <gcf-owl-bot[bot]@users.noreply.github.com> Co-authored-by: Anthonios Partheniou <partheniou@google.com> Co-authored-by: ohmayr <omairnaveed@ymail.com>

Author: 3 people

packages/google-cloud-dialogflow-cx/docs/dialogflowcx_v3beta1/conversation_history.rst

@@ -0,0 +1,10 @@
+ConversationHistory
+-------------------------------------
+
+.. automodule:: google.cloud.dialogflowcx_v3beta1.services.conversation_history
+ :members:
+ :inherited-members:
+
+.. automodule:: google.cloud.dialogflowcx_v3beta1.services.conversation_history.pagers
+ :members:
+ :inherited-members:

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

@@ -5,6 +5,7 @@ Services for Google Cloud Dialogflowcx v3beta1 API
 
  agents
  changelogs
+ conversation_history
  deployments
  entity_types
  environments

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.33.0" # {x-release-please-version}
+__version__ = "0.0.0" # {x-release-please-version}

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.33.0" # {x-release-please-version}
+__version__ = "0.0.0" # {x-release-please-version}

packages/google-cloud-dialogflow-cx/google/cloud/dialogflowcx_v3/services/agents/async_client.py

@@ -17,6 +17,7 @@
 import os
 import re
 from typing import (
+ Callable,
  Dict,
  Mapping,
  MutableMapping,
@@ -681,7 +682,9 @@ def __init__(
  self,
  *,
  credentials: Optional[ga_credentials.Credentials] = None,
- transport: Optional[Union[str, AgentsTransport]] = None,
+ transport: Optional[
+ Union[str, AgentsTransport, Callable[..., AgentsTransport]]
+ ] = None,
  client_options: Optional[Union[client_options_lib.ClientOptions, dict]] = None,
  client_info: gapic_v1.client_info.ClientInfo = DEFAULT_CLIENT_INFO,
  ) -> None:
@@ -693,9 +696,11 @@ def __init__(
  credentials identify the application to the service; if none
  are specified, the client will attempt to ascertain the
  credentials from the environment.
- transport (Union[str, AgentsTransport]): The
- transport to use. If set to None, a transport is chosen
- automatically.
+ transport (Optional[Union[str,AgentsTransport,Callable[..., AgentsTransport]]]):
+ The transport to use, or a Callable that constructs and returns a new transport.
+ If a Callable is given, it will be called with the same set of initialization
+ arguments as used in the AgentsTransport constructor.
+ If set to None, a transport is chosen automatically.
  client_options (Optional[Union[google.api_core.client_options.ClientOptions, dict]]):
  Custom options for the client.
 
@@ -801,8 +806,15 @@ def __init__(
  api_key_value
  )
 
- Transport = type(self).get_transport_class(cast(str, transport))
- self._transport = Transport(
+ transport_init: Union[
+ Type[AgentsTransport], Callable[..., AgentsTransport]
+ ] = (
+ type(self).get_transport_class(transport)
+ if isinstance(transport, str) or transport is None
+ else cast(Callable[..., AgentsTransport], transport)
+ )
+ # initialize with the provided callable or the passed in class
+ self._transport = transport_init(
  credentials=credentials,
  credentials_file=self._client_options.credentials_file,
  host=self._api_endpoint,
@@ -880,19 +892,17 @@ def sample_list_agents():
 
  """
  # Create or coerce a protobuf request object.
- # Quick check: If we got a request object, we should *not* have
- # gotten any keyword arguments that map to the request.
+ # - Quick check: If we got a request object, we should *not* have
+ #  gotten any keyword arguments that map to the request.
  has_flattened_params = any([parent])
  if request is not None and has_flattened_params:
  raise ValueError(
  "If the `request` argument is set, then none of "
  "the individual field arguments should be set."
  )
 
- # Minor optimization to avoid making a copy if the user passes
- # in a agent.ListAgentsRequest.
- # There's no risk of modifying the input as we've already verified
- # there are no flattened fields.
+ # - Use the request object if provided (there's no risk of modifying the input as
+ # there are no flattened fields), or create one.
  if not isinstance(request, agent.ListAgentsRequest):
  request = agent.ListAgentsRequest(request)
  # If we have keyword arguments corresponding to fields on the
@@ -1007,19 +1017,17 @@ def sample_get_agent():
 
  """
  # Create or coerce a protobuf request object.
- # Quick check: If we got a request object, we should *not* have
- # gotten any keyword arguments that map to the request.
+ # - Quick check: If we got a request object, we should *not* have
+ #  gotten any keyword arguments that map to the request.
  has_flattened_params = any([name])
  if request is not None and has_flattened_params:
  raise ValueError(
  "If the `request` argument is set, then none of "
  "the individual field arguments should be set."
  )
 
- # Minor optimization to avoid making a copy if the user passes
- # in a agent.GetAgentRequest.
- # There's no risk of modifying the input as we've already verified
- # there are no flattened fields.
+ # - Use the request object if provided (there's no risk of modifying the input as
+ # there are no flattened fields), or create one.
  if not isinstance(request, agent.GetAgentRequest):
  request = agent.GetAgentRequest(request)
  # If we have keyword arguments corresponding to fields on the
@@ -1141,19 +1149,17 @@ def sample_create_agent():
 
  """
  # Create or coerce a protobuf request object.
- # Quick check: If we got a request object, we should *not* have
- # gotten any keyword arguments that map to the request.
+ # - Quick check: If we got a request object, we should *not* have
+ #  gotten any keyword arguments that map to the request.
  has_flattened_params = any([parent, agent])
  if request is not None and has_flattened_params:
  raise ValueError(
  "If the `request` argument is set, then none of "
  "the individual field arguments should be set."
  )
 
- # Minor optimization to avoid making a copy if the user passes
- # in a gcdc_agent.CreateAgentRequest.
- # There's no risk of modifying the input as we've already verified
- # there are no flattened fields.
+ # - Use the request object if provided (there's no risk of modifying the input as
+ # there are no flattened fields), or create one.
  if not isinstance(request, gcdc_agent.CreateAgentRequest):
  request = gcdc_agent.CreateAgentRequest(request)
  # If we have keyword arguments corresponding to fields on the
@@ -1277,19 +1283,17 @@ def sample_update_agent():
 
  """
  # Create or coerce a protobuf request object.
- # Quick check: If we got a request object, we should *not* have
- # gotten any keyword arguments that map to the request.
+ # - Quick check: If we got a request object, we should *not* have
+ #  gotten any keyword arguments that map to the request.
  has_flattened_params = any([agent, update_mask])
  if request is not None and has_flattened_params:
  raise ValueError(
  "If the `request` argument is set, then none of "
  "the individual field arguments should be set."
  )
 
- # Minor optimization to avoid making a copy if the user passes
- # in a gcdc_agent.UpdateAgentRequest.
- # There's no risk of modifying the input as we've already verified
- # there are no flattened fields.
+ # - Use the request object if provided (there's no risk of modifying the input as
+ # there are no flattened fields), or create one.
  if not isinstance(request, gcdc_agent.UpdateAgentRequest):
  request = gcdc_agent.UpdateAgentRequest(request)
  # If we have keyword arguments corresponding to fields on the
@@ -1377,19 +1381,17 @@ def sample_delete_agent():
  sent along with the request as metadata.
  """
  # Create or coerce a protobuf request object.
- # Quick check: If we got a request object, we should *not* have
- # gotten any keyword arguments that map to the request.
+ # - Quick check: If we got a request object, we should *not* have
+ #  gotten any keyword arguments that map to the request.
  has_flattened_params = any([name])
  if request is not None and has_flattened_params:
  raise ValueError(
  "If the `request` argument is set, then none of "
  "the individual field arguments should be set."
  )
 
- # Minor optimization to avoid making a copy if the user passes
- # in a agent.DeleteAgentRequest.
- # There's no risk of modifying the input as we've already verified
- # there are no flattened fields.
+ # - Use the request object if provided (there's no risk of modifying the input as
+ # there are no flattened fields), or create one.
  if not isinstance(request, agent.DeleteAgentRequest):
  request = agent.DeleteAgentRequest(request)
  # If we have keyword arguments corresponding to fields on the
@@ -1487,10 +1489,8 @@ def sample_export_agent():
 
  """
  # Create or coerce a protobuf request object.
- # Minor optimization to avoid making a copy if the user passes
- # in a agent.ExportAgentRequest.
- # There's no risk of modifying the input as we've already verified
- # there are no flattened fields.
+ # - Use the request object if provided (there's no risk of modifying the input as
+ # there are no flattened fields), or create one.
  if not isinstance(request, agent.ExportAgentRequest):
  request = agent.ExportAgentRequest(request)
 
@@ -1612,10 +1612,8 @@ def sample_restore_agent():
 
  """
  # Create or coerce a protobuf request object.
- # Minor optimization to avoid making a copy if the user passes
- # in a agent.RestoreAgentRequest.
- # There's no risk of modifying the input as we've already verified
- # there are no flattened fields.
+ # - Use the request object if provided (there's no risk of modifying the input as
+ # there are no flattened fields), or create one.
  if not isinstance(request, agent.RestoreAgentRequest):
  request = agent.RestoreAgentRequest(request)
 
@@ -1707,10 +1705,8 @@ def sample_validate_agent():
 
  """
  # Create or coerce a protobuf request object.
- # Minor optimization to avoid making a copy if the user passes
- # in a agent.ValidateAgentRequest.
- # There's no risk of modifying the input as we've already verified
- # there are no flattened fields.
+ # - Use the request object if provided (there's no risk of modifying the input as
+ # there are no flattened fields), or create one.
  if not isinstance(request, agent.ValidateAgentRequest):
  request = agent.ValidateAgentRequest(request)
 
@@ -1800,19 +1796,17 @@ def sample_get_agent_validation_result():
 
  """
  # Create or coerce a protobuf request object.
- # Quick check: If we got a request object, we should *not* have
- # gotten any keyword arguments that map to the request.
+ # - Quick check: If we got a request object, we should *not* have
+ #  gotten any keyword arguments that map to the request.
  has_flattened_params = any([name])
  if request is not None and has_flattened_params:
  raise ValueError(
  "If the `request` argument is set, then none of "
  "the individual field arguments should be set."
  )
 
- # Minor optimization to avoid making a copy if the user passes
- # in a agent.GetAgentValidationResultRequest.
- # There's no risk of modifying the input as we've already verified
- # there are no flattened fields.
+ # - Use the request object if provided (there's no risk of modifying the input as
+ # there are no flattened fields), or create one.
  if not isinstance(request, agent.GetAgentValidationResultRequest):
  request = agent.GetAgentValidationResultRequest(request)
  # If we have keyword arguments corresponding to fields on the
@@ -1915,19 +1909,17 @@ def sample_get_generative_settings():
  Settings for Generative AI.
  """
  # Create or coerce a protobuf request object.
- # Quick check: If we got a request object, we should *not* have
- # gotten any keyword arguments that map to the request.
+ # - Quick check: If we got a request object, we should *not* have
+ #  gotten any keyword arguments that map to the request.
  has_flattened_params = any([name, language_code])
  if request is not None and has_flattened_params:
  raise ValueError(
  "If the `request` argument is set, then none of "
  "the individual field arguments should be set."
  )
 
- # Minor optimization to avoid making a copy if the user passes
- # in a agent.GetGenerativeSettingsRequest.
- # There's no risk of modifying the input as we've already verified
- # there are no flattened fields.
+ # - Use the request object if provided (there's no risk of modifying the input as
+ # there are no flattened fields), or create one.
  if not isinstance(request, agent.GetGenerativeSettingsRequest):
  request = agent.GetGenerativeSettingsRequest(request)
  # If we have keyword arguments corresponding to fields on the
@@ -2031,19 +2023,17 @@ def sample_update_generative_settings():
  Settings for Generative AI.
  """
  # Create or coerce a protobuf request object.
- # Quick check: If we got a request object, we should *not* have
- # gotten any keyword arguments that map to the request.
+ # - Quick check: If we got a request object, we should *not* have
+ #  gotten any keyword arguments that map to the request.
  has_flattened_params = any([generative_settings, update_mask])
  if request is not None and has_flattened_params:
  raise ValueError(
  "If the `request` argument is set, then none of "
  "the individual field arguments should be set."
  )
 
- # Minor optimization to avoid making a copy if the user passes
- # in a agent.UpdateGenerativeSettingsRequest.
- # There's no risk of modifying the input as we've already verified
- # there are no flattened fields.
+ # - Use the request object if provided (there's no risk of modifying the input as
+ # there are no flattened fields), or create one.
  if not isinstance(request, agent.UpdateGenerativeSettingsRequest):
  request = agent.UpdateGenerativeSettingsRequest(request)
  # If we have keyword arguments corresponding to fields on the

packages/google-cloud-dialogflow-cx/google/cloud/dialogflowcx_v3/services/agents/client.py

@@ -57,7 +57,7 @@ def __init__(
  credentials: Optional[ga_credentials.Credentials] = None,
  credentials_file: Optional[str] = None,
  scopes: Optional[Sequence[str]] = None,
- channel: Optional[grpc.Channel] = None,
+ channel: Optional[Union[grpc.Channel, Callable[..., grpc.Channel]]] = None,
  api_mtls_endpoint: Optional[str] = None,
  client_cert_source: Optional[Callable[[], Tuple[bytes, bytes]]] = None,
  ssl_channel_credentials: Optional[grpc.ChannelCredentials] = None,
@@ -77,14 +77,17 @@ def __init__(
  credentials identify the application to the service; if none
  are specified, the client will attempt to ascertain the
  credentials from the environment.
- This argument is ignored if ``channel`` is provided.
+ This argument is ignored if a ``channel`` instance is provided.
  credentials_file (Optional[str]): A file with credentials that can
  be loaded with :func:`google.auth.load_credentials_from_file`.
- This argument is ignored if ``channel`` is provided.
+ This argument is ignored if a ``channel`` instance is provided.
  scopes (Optional(Sequence[str])): A list of scopes. This argument is
- ignored if ``channel`` is provided.
- channel (Optional[grpc.Channel]): A ``Channel`` instance through
- which to make calls.
+ ignored if a ``channel`` instance is provided.
+ channel (Optional[Union[grpc.Channel, Callable[..., grpc.Channel]]]):
+ A ``Channel`` instance through which to make calls, or a Callable
+ that constructs and returns one. If set to None, ``self.create_channel``
+ is used to create the channel. If a Callable is given, it will be called
+ with the same arguments as used in ``self.create_channel``.
  api_mtls_endpoint (Optional[str]): Deprecated. The mutual TLS endpoint.
  If provided, it overrides the ``host`` argument and tries to create
  a mutual TLS channel with client SSL credentials from
@@ -94,11 +97,11 @@ def __init__(
  private key bytes, both in PEM format. It is ignored if
  ``api_mtls_endpoint`` is None.
  ssl_channel_credentials (grpc.ChannelCredentials): SSL credentials
- for the grpc channel. It is ignored if ``channel`` is provided.
+ for the grpc channel. It is ignored if a ``channel`` instance is provided.
  client_cert_source_for_mtls (Optional[Callable[[], Tuple[bytes, bytes]]]):
  A callback to provide client certificate bytes and private key bytes,
  both in PEM format. It is used to configure a mutual TLS channel. It is
- ignored if ``channel`` or ``ssl_channel_credentials`` is provided.
+ ignored if a ``channel`` instance or ``ssl_channel_credentials`` is provided.
  quota_project_id (Optional[str]): An optional project to use for billing
  and quota.
  client_info (google.api_core.gapic_v1.client_info.ClientInfo):
@@ -125,7 +128,7 @@ def __init__(
  if client_cert_source:
  warnings.warn("client_cert_source is deprecated", DeprecationWarning)
 
- if channel:
+ if isinstance(channel, grpc.Channel):
  # Ignore credentials if a channel was passed.
  credentials = False
  # If a channel was explicitly provided, set it.
@@ -166,7 +169,9 @@ def __init__(
  )
 
  if not self._grpc_channel:
- self._grpc_channel = type(self).create_channel(
+ # initialize with the provided callable or the default channel
+ channel_init = channel or type(self).create_channel
+ self._grpc_channel = channel_init(
  self._host,
  # use the credentials which are saved
  credentials=self._credentials,