docs: clarify descriptions of the AdvancedSettings and WebhookRequest data types

Google APIs · copybara-github · commit c425ac6db944 · 2022-06-29T09:55:01.000-07:00
PiperOrigin-RevId: 458000126
diff --git a/google/cloud/dialogflow/cx/v3beta1/advanced_settings.proto b/google/cloud/dialogflow/cx/v3beta1/advanced_settings.proto
@@ -29,7 +29,13 @@ option ruby_package = "Google::Cloud::Dialogflow::CX::V3beta1";
 
 // Hierarchical advanced settings for agent/flow/page/fulfillment/parameter.
 // Settings exposed at lower level overrides the settings exposed at higher
-// level.
+// level. Overriding occurs at the sub-setting level. For example, the
+// playback_interruption_settings at fulfillment level only overrides the
+// playback_interruption_settings at the agent level, leaving other settings
+// at the agent level unchanged.
+//
+// DTMF settings does not override each other. DTMF settings set at different
+// levels define DTMF detections running in parallel.
 //
 // Hierarchy: Agent->Flow->Page->Fulfillment/Parameter.
 message AdvancedSettings {
diff --git a/google/cloud/dialogflow/cx/v3beta1/webhook.proto b/google/cloud/dialogflow/cx/v3beta1/webhook.proto
@@ -273,6 +273,9 @@ message DeleteWebhookRequest {
 
 // The request message for a webhook call. The request is sent as a JSON object
 // and the field names will be presented in camel cases.
+//
+// You may see undocumented fields in an actual request. These fields are used
+// internally by Dialogflow and should be ignored.
 message WebhookRequest {
   // Represents fulfillment information communicated to the webhook.
   message FulfillmentInfo {
