Class GenericWebService (1.33.0)

GenericWebService(mapping=None, *, ignore_unknown_fields=False, **kwargs)

Represents configuration for a generic web service.

Attributes
Name	Description
`uri`	`str` Required. The webhook URI for receiving POST requests. It must use https protocol.
`username`	`str` The user name for HTTP Basic authentication.
`password`	`str` The password for HTTP Basic authentication.
`request_headers`	`MutableMapping[str, str]` The HTTP request headers to send together with webhook requests.
`allowed_ca_certs`	`MutableSequence[bytes]` Optional. Specifies a list of allowed custom CA certificates (in DER format) for HTTPS verification. This overrides the default SSL trust store. If this is empty or unspecified, Dialogflow will use Google's default trust store to verify certificates. N.B. Make sure the HTTPS server certificates are signed with "subject alt name". For instance a certificate can be self-signed using the following command, :: openssl x509 -req -days 200 -in example.com.csr \ -signkey example.com.key \ -out example.com.crt \ -extfile <(printf "\nsubjectaltname='DNS:www.example.com' ")="">
`oauth_config`	`google.cloud.dialogflowcx_v3beta1.types.Webhook.GenericWebService.OAuthConfig` Optional. The OAuth configuration of the webhook. If specified, Dialogflow will initiate the OAuth client credential flow to exchange an access token from the 3rd party platform and put it in the auth header.
`service_agent_auth`	`google.cloud.dialogflowcx_v3beta1.types.Webhook.GenericWebService.ServiceAgentAuth` Optional. Indicate the auth token type generated from the `Diglogflow service agent
`webhook_type`	`google.cloud.dialogflowcx_v3beta1.types.Webhook.GenericWebService.WebhookType` Optional. Type of the webhook.
`http_method`	`google.cloud.dialogflowcx_v3beta1.types.Webhook.GenericWebService.HttpMethod` Optional. HTTP method for the flexible webhook calls. Standard webhook always uses POST.
`request_body`	`str` Optional. Defines a custom JSON object as request body to send to flexible webhook.
`parameter_mapping`	`MutableMapping[str, str]` Optional. Maps the values extracted from specific fields of the flexible webhook response into session parameters. - Key: session parameter name - Value: field path in the webhook response

Classes

HttpMethod

HttpMethod(value)

HTTP method to use when calling webhooks.

Values: HTTP_METHOD_UNSPECIFIED (0): HTTP method not specified. POST (1): HTTP POST Method. GET (2): HTTP GET Method. HEAD (3): HTTP HEAD Method. PUT (4): HTTP PUT Method. DELETE (5): HTTP DELETE Method. PATCH (6): HTTP PATCH Method. OPTIONS (7): HTTP OPTIONS Method.

OAuthConfig

OAuthConfig(mapping=None, *, ignore_unknown_fields=False, **kwargs)

Represents configuration of OAuth client credential flow for 3rd party API authentication.

ParameterMappingEntry

ParameterMappingEntry(mapping=None, *, ignore_unknown_fields=False, **kwargs)

The abstract base class for a message.

Parameters
Name	Description
`kwargs`	`dict` Keys and values corresponding to the fields of the message.
`mapping`	`Union[dict, .Message]` A dictionary or message to be used to determine the values for this message.
`ignore_unknown_fields`	`Optional(bool)` If True, do not raise errors for unknown fields. Only applied if `mapping` is a mapping type or there are keyword parameters.

RequestHeadersEntry

RequestHeadersEntry(mapping=None, *, ignore_unknown_fields=False, **kwargs)

The abstract base class for a message.

Parameters
Name	Description
`kwargs`	`dict` Keys and values corresponding to the fields of the message.
`mapping`	`Union[dict, .Message]` A dictionary or message to be used to determine the values for this message.
`ignore_unknown_fields`	`Optional(bool)` If True, do not raise errors for unknown fields. Only applied if `mapping` is a mapping type or there are keyword parameters.

ServiceAgentAuth

ServiceAgentAuth(value)

Indicate the auth token type generated from the Diglogflow service agent <https://cloud.google.com/iam/docs/service-agents#dialogflow-service-agent>__.

Values: SERVICE_AGENT_AUTH_UNSPECIFIED (0): Service agent auth type unspecified. Default to ID_TOKEN. NONE (1): No token used. ID_TOKEN (2): Use ID token <https://cloud.google.com/docs/authentication/token-types#id> generated from service agent. This can be used to access Cloud Function and Cloud Run after you grant Invoker role to service-<PROJECT-NUMBER>@gcp-sa-dialogflow.iam.gserviceaccount.com. ACCESS_TOKEN (3): Use access token <https://cloud.google.com/docs/authentication/token-types#access> generated from service agent. This can be used to access other Google Cloud APIs after you grant required roles to service-<PROJECT-NUMBER>@gcp-sa-dialogflow.iam.gserviceaccount.com.

WebhookType

WebhookType(value)

Represents the type of webhook configuration.

Values: WEBHOOK_TYPE_UNSPECIFIED (0): Default value. This value is unused. STANDARD (1): Represents a standard webhook. FLEXIBLE (2): Represents a flexible webhook.