docs: clarified gcs_bucket field of the SecuritySettings message

Google APIs · copybara-github · commit 22d2bdaeef00 · 2022-09-29T11:34:12.000-07:00
PiperOrigin-RevId: 477778532
diff --git a/google/cloud/dialogflow/cx/v3beta1/BUILD.bazel b/google/cloud/dialogflow/cx/v3beta1/BUILD.bazel
@@ -96,6 +96,7 @@ java_gapic_library(
     srcs = [":cx_proto_with_info"],
     gapic_yaml = None,
     grpc_service_config = "dialogflow_grpc_service_config.json",
+    rest_numeric_enums = False,
     service_yaml = "dialogflow_v3beta1.yaml",
     test_deps = [
         ":cx_java_grpc",
@@ -191,6 +192,7 @@ go_gapic_library(
     grpc_service_config = "dialogflow_grpc_service_config.json",
     importpath = "cloud.google.com/go/dialogflow/cx/apiv3beta1;cx",
     metadata = True,
+    rest_numeric_enums = False,
     service_yaml = "dialogflow_v3beta1.yaml",
     transport = "grpc+rest",
     deps = [
@@ -229,6 +231,7 @@ load(
     "@com_google_googleapis_imports//:imports.bzl",
     "py_gapic_assembly_pkg",
     "py_gapic_library",
+    "py_test",
 )
 
 py_gapic_library(
@@ -239,20 +242,23 @@ py_gapic_library(
         "python-gapic-name=dialogflowcx",
         "python-gapic-namespace=google.cloud",
     ],
+    rest_numeric_enums = False,
     service_yaml = "dialogflow_v3beta1.yaml",
     transport = "grpc",
+    deps = [
+    ],
 )
 
 # Uncomment once https://github.com/googleapis/gapic-generator-python/issues/1376 is fixed
-#py_test(
-#    name = "cx_py_gapic_test",
-#    srcs = [
-#        "cx_py_gapic_pytest.py",
-#        "cx_py_gapic_test.py",
-#    ],
-#    legacy_create_init = False,
-#    deps = [":cx_py_gapic"],
-#)
+# py_test(
+#     name = "cx_py_gapic_test",
+#     srcs = [
+#         "cx_py_gapic_pytest.py",
+#         "cx_py_gapic_test.py",
+#     ],
+#     legacy_create_init = False,
+#     deps = [":cx_py_gapic"],
+# )
 
 # Open Source Packages
 py_gapic_assembly_pkg(
@@ -288,6 +294,7 @@ php_gapic_library(
     name = "cx_php_gapic",
     srcs = [":cx_proto_with_info"],
     grpc_service_config = "dialogflow_grpc_service_config.json",
+    rest_numeric_enums = False,
     service_yaml = "dialogflow_v3beta1.yaml",
     deps = [
         ":cx_php_grpc",
@@ -321,9 +328,9 @@ nodejs_gapic_library(
     extra_protoc_parameters = ["metadata"],
     grpc_service_config = "dialogflow_grpc_service_config.json",
     package = "google.cloud.dialogflow.cx.v3beta1",
+    rest_numeric_enums = False,
     service_yaml = "dialogflow_v3beta1.yaml",
     deps = [],
-    mixins = "google.longrunning.Operations;google.cloud.location.Locations",
 )
 
 nodejs_gapic_assembly_pkg(
@@ -368,6 +375,7 @@ ruby_cloud_gapic_library(
         "ruby-cloud-product-url=https://cloud.google.com/dialogflow",
     ],
     grpc_service_config = "dialogflow_grpc_service_config.json",
+    rest_numeric_enums = False,
     ruby_cloud_description = "Dialogflow is an end-to-end, build-once deploy-everywhere development suite for creating conversational interfaces for websites, mobile applications, popular messaging platforms, and IoT devices. You can use it to build interfaces (such as chatbots and conversational IVR) that enable natural and rich interactions between your users and your business. This client is for Dialogflow CX, providing an advanced agent type suitable for large or very complex agents.",
     ruby_cloud_title = "Dialogflow CX V3beta1",
     service_yaml = "dialogflow_v3beta1.yaml",
@@ -414,6 +422,7 @@ csharp_gapic_library(
     srcs = [":cx_proto_with_info"],
     common_resources_config = "@gax_dotnet//:Google.Api.Gax/ResourceNames/CommonResourcesConfig.json",
     grpc_service_config = "dialogflow_grpc_service_config.json",
+    rest_numeric_enums = False,
     service_yaml = "dialogflow_v3beta1.yaml",
     deps = [
         ":cx_csharp_grpc",
diff --git a/google/cloud/dialogflow/cx/v3beta1/security_settings.proto b/google/cloud/dialogflow/cx/v3beta1/security_settings.proto
@@ -231,10 +231,11 @@ message SecuritySettings {
       OGG = 3;
     }
 
-    // Cloud Storage bucket to export audio record to. You need to grant
-    // `service-<Conversation Project
-    // Number>@gcp-sa-dialogflow.iam.gserviceaccount.com` the `Storage Object
-    // Admin` role in this bucket.
+    // Cloud Storage bucket to export audio record to.
+    // Setting this field would grant the Storage Object Creator role to
+    // the Dialogflow Service Agent.
+    // API caller that tries to modify this field should have the permission of
+    // storage.buckets.setIamPolicy.
     string gcs_bucket = 1;
 
     // Filename pattern for exported audio.
